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Preface 


A Note About SunView 


Companion documents 


Welcome to the Sun Workstation. This document introduces the basic tools you 
need to use the system. We assume that you are new to the Sun Workstation and 
have little or no experience with SunOS or similar operating systems. The infor¬ 
mation we present applies particularly to Sun products; most of the information 
is useful to anyone using SunOS. 

We provide exercises to learn the system, not detailed explanations of the inner 
workings of commands and programs. In each of the Beginner’s Guides , we 
refer you to the other Sun documentation, drawing a road map for you to follow 
when you wish to learn more about a certain topic. 

Getting Started with SunOS: Beginner’s Guide describes the workstation, the 
commands you will use most frequently, the keyboard, the terminal screen, and 
the SunOS system file stmcture. In addition, this manual presents simple editing, 
formatting, and searching programs, and includes special sections that give 
timesaving features, online documentation, where to learn more, a command 
summary, a glossary, an annotated bibliography, and a quick reference. 

Many of you wiU be using SunView, Sun’s windows system for the Sun Works¬ 
tation. This manual gives a brief introduction to SunView in its chapter on the 
terminal screen and mouse. Because many of SimView’s operations are so basic 
to using the Workstation, you may want to look at the SunView 1 Beginner’s 
Guide as you read this manual. Nonetheless, we recommend that you read the 
first four or five chapters of this manual before going on to the SunView 1 
Beginner’s Guide. These chapters are very basic and will help you understand 
SunView better. 

Although the documents in Sun’s Beginner’s Guides set can be read in any order, 
we suggest the following reading sequence for the new user; 
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Preface — Continued 


Getting Started with SunOS: Beginner’s Guide 

SunView 1 Beginner’s Guide 

Mail and Messages: Beginner’s Guide 

Using the Network: Beginner’s Guide 

Setting Up Your SunOS Environment: Beginner’s Guide 

Doing More with SunOS: Beginner’s Guide 

Self-Help with Problems: Beginner’s Guide 

In addition, the following manuals will prove useful to you: 

SunOS Reference Manual 
Editing Text Files 
Formatting Documents 
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A Work Session 


A Work Session .. 3 

1.1. Log In. 4 

1.2. Change Your Password. 6 

1.3. Log Out. 7 










A Work Session 


Before you start your first SunOS woric session, you will need to make sure that 
your system hardware is set up, that you have an account on your system, and 
that, when possible, you can ask a regular user of the system for help.^ 

This chapter wiU help you learn how to: 

□ log in to the machine 

□ set and change your password, and 

□ log out 

Turn on the workstation (for many machines, the switch is on the back) and sit in 
front of it while you read this tutorial, so you can try the examples, and so you 
can remember them later on. If something does not woik exactly the way you 
expect, and it stiU won’t work after you make a few good guesses, then ask a reg¬ 
ular user of the system for help. Or, look in Self-Help with Problems: Beginner’s 
Guide. 

Don’t be afraid to play with the computer— it won’t bite you. The best way to 
learn is to dig in confidently and try some examples. 


1 Hopefully, your system administrator wOl have arranged this for you. If not, or if you are the system 
administrator, consult the System and Network Administration manual to set up the system and accounts before 
reading this manual. 


microsystems 
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4 Getting Started with SunOS 


1.1. Login 


On your workstation screen, you should see something like this: 


Figure 1-1 Screen With Login Prompt 


venus% login: | 


This is called the system/<3gm/jrompr. In most cases, the word before login: 
is the name of your machine; for this example, the machine name, or hostname, 
is venus. 


Note: SunOS is an operating system, 
in other words, a coilection of pro¬ 
grams that monitors the use of the 
machine and supervises the other 
programs executed by it. 


The SunOS operating system wiU allow more than one person to use the system 
at the same time, so it requires you to identify yourself. 

When you get your account on the system, remember your username and pass¬ 
word. Your username (also known as a login name, a login id, a user id, or an 
account) identifies you to the system and to other users. Your password restricts 
use of your account to those people who know the password. You’ll learn how to 
change your password in the section on changing your password. Section 1.2 . 


Note: If you make a mistake in typ¬ 
ing a character of y our us ername or 
password, type the I Del I key to 
delete, or erase, the character, then 
type the correct character in place 
of the incorrect one. 


At the login prompt, type your username, followed by the carriage return key 
I Return I . (for the purposes of instmction in this manual, the bold-faced characters 
represent what you type to the system; the system types the characters that are 
the regular font intensity): 
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Chapter 1 — A Work Session 5 


Figure 1-2 The Password Prompt 




venus login: xnedlci 


Password: 


V- 

j 


The username is medici in this example. Be aware that the Sun system is 
case-sensitive — it distinguishes between lower-case and upper-case characters 
— and has a strong orientation toward lower-case characters. 


Note: Watch out for the I Gaos I key, 
if there is one on your keyboard. If 
you should log in using upper-case 
for your username or password, see 
the section on logging out. Section 
1.3 to log out and try logging in 
again. 


The system will not do anything until you complete the command by typing a 
carriage return (the I Return I key). After it accepts your username (it may 
“think” for a second or two), it will prompt you for your password.^ 

At the password prompt, type your password. 

As you can see, the system will not echo (type out) your password on the screen. 
This is so that other users who are peeking over your shoulder will not discover 
your password. 

Don’t forget to type (Return I after your password, so the system will interpret 
what you typed. From now on, you’ll have to type (Return I . after each command 
without a reminder from this manual. 


When you mistype your username or your password, the system wiU respond like 
this: 


Figure 1-3 Incorrect Login 


r 


venus login: xndci 


Password: 


Login incorrect. 


login: 


^. 

J 


Simply retype your username and password to log in.^ 

After you correctly type your username and password, the system will pause for 
less than a minute, then type out something like this: 


Figure 1-4 


System Login Irformation 


venus login: medicl 
Password: 

Last login: Fri Oct 31 23:59:59 from console 

Sun SunOS 4.2 Release 3.0 (DIONE_CLIENT) #1: Fri Feb 14 00: 

venus% 


^ If the account does not have a password assigned to it, the system will log you in without asking for a 
password. 

3 If the system persists in refusing to log you in, your account may not be set up properly. Try talking with 
your system administrator, or look in the System and Network Administration manual. 
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6 Getting Started with SunOS 


In this example, the first line the system types teUs when your username last 
logged in to the system (console refers to a login while sitting at the worksta¬ 
tion keyboard). When you log in, you may want to check this line to see if it 
confirms your recollection of when you last logged in, so you can be aware if 
someone else is using your account. The second line, with the word SunOS in 
it, teUs some information about the version of the system that is running. Don’t 
worry about this for now."^ 

In addition, the system may type a login message that the operator has entered on 
the system to keep you informed about important system events, such as down¬ 
time, when the system is shut down, usually for system maintenance. 

All of the information that the system types just after you log in is known as the 
message of the day. 

The system may also inform you that: 

You have mail. 

For more information on how to read your mail, see Mail and Messages: 
Beginner’s Guide. 

The last line in this example is the command prompt, consisting of your machine 
name, venus in these examples, and a percent sign (%).^ 

Congratulations! At this point, you have successfully logged in to the Sun 
Workstation. 


1.2. Change Your Right after you log in for the first time, change your password, so you are the 

Password only one who has easy access to your account. Change your password immedi¬ 

ately if you believe someone has used your account without your permission. 
You may want to change your password periodically for security reasons. 


Note: One good way to remember Your personal password is your choice entirely. Pick a password that you can 

a password is to think of a word that remember without writing it down. For convenience, you may want to pick a 

IS the answer to a provocative ques- . . - 

tiQn password that is easy to type. 

Then, type the command passwd as follows (if no password was assigned to 
your account, the system will skip the Old Password: prompt): 


^ K you have ever logged in to your woricstation from another system, you will see something like this: 

venus login: xnedlci 
Password: 

Last login: Fri Oct 31 23:59:59 from pandora 

Sun SunOS 4.2 Release 4.0 (DIONE_CLIENT) #1: Fri Feb 14 00:00:01 PST 1988 
venus% 

As before, one line of system information lets you know the last time your username accessed the account, 
but this time it specifies from which machine (pandora) you last logged in. 

^ In some cases the command prompt may be just a percent sign (%), or just a doUar sign ($). To customize 
your command prompt, consult Setting Up Your SunOS Environment: Beginner’s Guide for information about 
the prompt environment variable. 
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Chapter 1 — A Work Session 7 


Figure 1-5 

Changing Your Password 



r ' ' ■■ ■ '■ ■■ ' ■ ■ ' ' ■ . 

venus% passwd . 

Changing password for medici on venus 

Old password: 

New password; 

Retype new password: 
venus% 

;:::x::x;:;:x:x:x:::;:::;:x:x>:x:::::;^ 



J 


When the system prompts you for 
Old password: 

type in your current password. Just as during log in, the system wiU not display 
any passwords typed at password prompts. Then, type in the new password you 
picked when you see the next system prompt: 

New password: 

Because the password does not echo, the system will ask you to retype it to 
prevent typographical accidents. 

Again, if the system doesn’t have a password for you, it won’t prompt you for 
Old password: 
it will skip directly to the 
New password: 

prompt, where you should enter the password you have picked. 

If you don’t remember your old password, or if you mistype it, the system refuses 
to alter you password and responds with 

Sorry 

If this happens repeatedly, contact your system administrator to get a new pass¬ 
word. 

On most systems, when you pick a password less than six characters long, the 
system wiU not allow you to enter it unless you are persistent. Keep on typing in 
the new password even though the system says: 

Please use a longer password. 

until the system agrees to make the change. 


1.3. Log Out After completing your woilc, it is important to log out, or stop the current session 

of your account’s access to the system. Anyone who walks by your woikstation 
or terminal will have access to the system using your account, unless you 
remember to log out. 

When you finish your work session, try to log out using the logout command: 


®sun 

Xr microsystems 
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Figure 1-6 Logging Out With logout 


( - 


venus% logout 


venus login: 




Another way to log out is to type I Ctrl-D I . the end-of-file character (explained 
further in the section of Chapter 4 on creating a file). To type a control character, 
hold down the (Ctrl I key while typing the letter key. In this example, hold down 
I Ctrl I and type the letter Even though I Ctrl-D I specifies an upper-case letter 
D, you can type d without the I Shift I key, in other words lower-case d, in con¬ 
junction with I Ctrl I . 

This is what it looks like: 


Figure 1-7 Logging OutWith Ctrl-D 


( - 


venus % '"D 


venus login: 

_ 

J 


Note: Turning off the workstation 
will not necessarily log you out. 

Most Sun systems do not have a 
“time-out” mechanism, so unless 
you log out explicitly, most often 
you will remain logged in to the sys¬ 
tem. 

Table 1-1 


After you log out successfully, the system will display the login prompt again for 
the next user to log in. 

When you encounter one of the following problems, respond as indicated in the 
table: 


Problems Logging Out 


Problem Solution 

System says: 

There are stopped jobs 

Type: 

logout 

two or three times 

System says: 

Not login shell 

Type: 

exit 
then type: 
logout 

I’m just completely stuck. 

(This usually works when 
logged into a machine over 
the network.) 

Try typing: 

1 Return 1 

f Return 1 


Try logging out and logging in again for practice. 

Congratulations! You’ve completed your first work session on a Sun. 


* You may wish to prevent I Ctrl-D I from logging you out. See the description of ignoreeof in Selling Up 
Your SunOS Environment: Beginner s Guide for informalion how to do this. 


Xr microsystems 
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The Keyboard 


2.1. Keyboard Layout You can type commands to the system with the ^cyfooard. The keyboard of a 

Sun workstation is like the keyboard of a standard typewriter, with the addition 
of some special keys. With your first work session, in Chapter 1 , you became 
acquainted with some of them. Now, you’ll review those keys and learn about a 
few more. 

Figure 2-1 The Sun Workstation Keyboard 
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Note: The system distinguishes To type most keyboard characters, simply find the key labeled with the appropri- 

betweei^e one key, QD md the letter gj-g character and press the key until the character appears on the screen, or the 

the zero key and the letter o key. desired action takes place. Be Careful not to press the key for too long because 

many keys will repeat their function, varying with the length of time you press 
the key. 

Remember that SunOS distinguishes between lower-case and upper-case charac¬ 
ters and, in general, prefers lower-case. 
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12 Getting Started with SunOS 


2.2. The Carriage Return One of the keys you encountered in Chapter 1 is [ Return I . the carriage return 
Key key. Located on the right of the keyboard, I Return ) causes the system to interpret 

a command line, or line that you are typing on, and execute it. Until you type 
[ Return I you can correct the command line.^ 


2.3. The Space Bar and the Use the space bar, located along the front of the keyboard, to add spaces to the 
Tab Key command line when necessary. 

The tab key, I Tab I acts like the space bar, but instead of inserting one space, it 
inserts up to eight spaces until the next tab stop. Tab stops are regular divisions 
of the input line. I Tab I is located on the upper left of the keyboard. 


2.4. The Delete and Back On each system, either the delete key, I Del I or the backspace key, I Back Spacel 

Space Keys allows you to back up one character and rub out, or erase, a specific character in 

the commands you type. To correct typing mistakes, you rub out as many char¬ 
acters as you wish, then retype these characters correctly. (Dell and I Back Space I 
are located near each other on the far right of the keyboard. 


Note: You can only rub out characters Some systems use I Del I as the rub out key; others use I Back Space 1 .^ The best 
back to the beginning of a command fjgmie jj pyj gn your own system is to try it. For example, when you want 

to use the pas s wd command to change your password, but you type paaswd 
by accident, then press the I Del I key four times, so that only pa shows, and 
retype the remaining characters, completing the correction. When your default 
rub out key is I Del I . it looks like this: 


Figure 2-2 Use of Delete Key 


Before: 



venus% paaswd 




J 


During: 

f -;- 

venus% pa 

' N 



J 


After: 


r 

A 

venus% passwd 


Changing password for medici on venus 


V 

J 


If instead, your default rub out key is I Back Space 1 . and you type I Del I . you see 
this: 


^ Leam more about commands and command lines in Chapter 5 . 

® If you wish to change your default rub out key from [ Del ) to [ Back Space L or vice versa, see Setting Up 
Your SunOS Environment: Beginner’s Guide . 
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Figure 2-3 Use of Delete Key When Back Space Key is Default 


During: 


Before: 


During: 


Before: 



venus% paaswd 



L. 



type I Back Space I . you will see something like this: 
Figure 2-4 Use of Back Space Key When Delete Key is Default 


ven\is% paaswd 


venus% 


r 

A 

vemi6% 


V_____ 

J 


Conversely, if I Del I is the default rub out key on your system, then when you 


Try “mistyping” and correcting a few commands using the key that acts as the 
rub out key on your system. 


2.5. Control Keys 


Figure 2-5 
Before: 

After: 


Control keys are keys that require you to press I Ctrl I and hold it down while typ¬ 
ing another key. In this way, the keys can have two functions, one when pressed 
alone, and another when pressed with I Ctrl 1 . This capability expands the useful¬ 
ness of the keyboard, similar to the way the I Shift I key allows you to type both 
lower-case and upper-case characters. 


The line kill character, I Ctrl-U I . erases the entire command line. For instance, to 
erase the entire “mistyped” passwd command, press the I Ctrl) key, and while 
you hold it down, type the ® key. It looks like this: 

The Line Kill Character 


( 

A 

Venus% pas sdw 


1 

j 


r 

A 

venus% 


V 

J 


Notice that 1 Ctrl-U 1 doesn’t appear on the screen when you type it. Some control 
keys appear on the screen; others don’t. 
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For now, don’t worry about understanding all about control keys. But, here are 
some useful control keys: 

Table 2-1 Control Keys 


Note: A word is a sequence of charac¬ 
ters surrounded by space(s) and/or 
tab(s). 


Another way to expand keyboard functionality is the use of escape keys or meta¬ 
keys. In contrast to control keys, escape keys require that you type the I Esc I key, 
release it, then type the complementing key. 

For example, to type I Esc-U I . press the I Esc) key, release it, then type the riTI 
key.^ 

Begiimers do not often use escape keys, so you only need to know about them in 
passing. 


2.6. Escape Keys or Meta- 
Keys 


Key 

Appearance 

Function 

ICtrl-U) 


Erases entire command line; 
the kill character 

1 Ctrl-W 1 


Erases last word on command line 

iCtrl-CJ 

"C 

Interrupts many programs and shell scripts 

1 Ctrl-Z 1 

"Z 

Suspends many programs and shell scripts 

1 Ctrl-S ] 

invisible 

Stops output of running program; prevents 
output from running off end of screen. 

{CM-0 ) 

invisible 

Resumes output from program stopped by 

CCS® 

1 Ctrl-01 

"0 

Throws away output from program 
without interrupting the program 

ICtrl-DI 

"D 

End-of-file character used for logout; 
also terminates file input 

(Ctrl-M 


Quits program and saves image of 
program in file called core for 
later debugging 


Some manuals refer to escape keys with any of these notations: 

<ESCAPE>-U <Esc>-U M-U <META>-U 


META-U 


wsun 

Xr microsystefTis 
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* 



The Terminal Screen and Mouse 


When you sit down in front of your Sun Workstation, you probably see some¬ 
thing like this:^® 

Figure 3-1 Parts of the Sun Workstation 



It is possible that you are not using a woilcstation, but a terminal. In this case, 
you won’t have a mouse or a mouse tablet, as in the illustration above. 

In Chapter 2, you experimented with the keyboard. All along, you’ve used the 
terminal screen to view your work. Read on for descriptions of the other parts of 
the workstation. 


If you are left-handed, you may wish to pul the mouse and the mouse tablet on the left side, not the right 
side, of the workstation. 


»sun 

XT microsystems 


17 
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3.1. The Cursor The cursor is the rectangular section on the screen that moves when you type. 

Notice that the keys you type appear in place of the cursor, and as soon as they 
appear, the cursor moves to the next character position on the screen. 

This is the way your screen will look (more or less) when you type in a com¬ 
mand, in this case the date command for getting the date and time: 

Figure 3-2 The Cursor 


A 



venus % 

date 


Fri.Sep 

23 15:06:29 PDT 1927 


venus% 

1 


V. 


.J 


In these manuals, we generally do not include a picture of the cursor when 
demonstrating commands. 


3.2. SunView Your workstation screen may look something like this: 

Figure 3-3 SunView in Operation 



When the screen looks like this, a windows system , called SunView , is running 
on the workstation. Each of the rectangular screen sections is a window. The 
small pictures are icons, which represent windows which are not being used. 

To learn more about SunView, the Sun window system, read the SunView 1 
Beginner’s Guide. 
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3.3. The Mouse and the A funny little device on a flat surface that looks like this are both parts of your 

Tablet workstation: 

Figure 3-4 Mouse and Tablet 



The funny little device is a mouse and the flat surface is its tablet. You can use 
the mouse (though it lacks fur) in conjunction with the window system on your 
workstation.^^ 

You’ve completed an overview of the parts of the Sun workstation. 


If you are running a window system presently, you may have trouble getting what you type to appear 
where you want it to appear. Try to make sure that the mouse cursor (usually a long arrow) stays inside the win¬ 
dow where what you type should appear. See the SunView 1 Beginner’s Guide for more information. 
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4.1. Security: 

Emptor 


4.2. Files 
Creating a File 


4 

Files and the File System 


A file is a “container” for your data on the system. Each file has a name. You 
can use files to store programs and documents for later use, much like a file 
cabinet. Then, you don’t have to retype them each time you want to use the sys¬ 
tem. This chapter explains what the file system is, including the files and direc¬ 
tories within it.^^ 


Caveat SunOS provides security mechanisms for the information you store on your 

machine. However, except for your password, you should assume that other peo¬ 
ple may be able to read what you type and store on the machine. 

Even once you know and use the security mechanisms SunOS offers, do not 
assume that a determined person could not find out vital information you store on 
the system. Unless you have to store confidential information on a computer, 
don’t. 

For more information about file protection, or security for files, see Doing More 
with SunOS: Beginner’s Guide, especially the portions that describe file protec¬ 
tions and the crypt command. 


You can display files, copy them, move them, edit them, and remove them. 


Many people create files using a text editor, but the command cat allows you 
to create files without learning a text editor. 

For the purpose of learning with a standard set of files, please type the examples 
as listed here. You can experiment as you go along, but be aware that future 
examples often depend on these examples. 


Throughout this chapter, you may encounter error messages or other problems. When this happens, see 
the Self-Help with Problems: Beginner s Guide. 

A text editor is a program designed specifically to help you create and make changes to the text within a 
file. To learn the Sun text editor vi, see Chapter 6 . 
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Be sure to put a space character 
before the > sign; the space charac¬ 
ter after the > sign is optional. 


Once you have logged in, you can create your first file. Type cat > filename, 
where filename is the name you wish to give the file, and [Return 1 .^^ 

Then type the contents of the file until you are done. Even though it may seem 
strange, complete the file with a I Ctrl-D I on a line by itself. For example, to 
create the file alice, with one of her famous quotations as its contents, type: 


Figure 4-1 


Creating a File 

venus% cat > alice 


"We reach for destinies beyond 
what we have come to know." 


"D 


V_ 

_ J 


Caution: If you cat > into an 
existing file, cat will replace the 
contents of that file with the text you 
type. 


You’ve created your first file! 

When you try it, don’t worry when I Ctrl-D I appears as " D and when the com¬ 
mand prompt (venus%) blots out the I Cnl-D 1 . 


The filename is like the label of a 
file folder in your desk. It’s a good 
idea to think of a filename that 
expresses meaning appropriate to 
the the contents of the file, but is 
short enough so that it is easy to 
type. 


You can name a file whatever you want, almost. Almost, that is, because some 
characters, called special characters, mean special things to the system. You 
could “confuse” the system without intending to if you used them. Special 
characters to watch out for are: \, >, <, |, &, ?, $, [, ], and *. Don’t 
try to put spaces in the middle of a filename. Filenames that begin with a period, 
like . login, are hidden files, and will not show up when you do a simple list¬ 
ing of files, as in the section on listing files later in this chapter.^^ 

Name and create another file or two for practice. 


Looking at a File 
( Ctrl-D 1 does not appear when look¬ 
ing at the file. That’s because the 
I Ctrl-D 1 isn’t part of the file; it’s the 
end-of-flle character, used to indi¬ 
cate to the system that the user has 
finished typing in a file. 


Now that you have created a file successfully, you can look at it by using the 
cat command again. When you type cat, followed by a filename — this time 
without a > sign — the system wiU type out the file specified by that filename 
on the screen. 

So, to look at the file alice created above, type: 


Figure 4-2 Looking at a File With cat 


r "" . .■■ . 

A 

venus% cat alice 


"We reach for dectinies beyond 


what we have come to know." 


venu3% 


V._ 

_ ) 


The command cat is an abbreviation of concatenate, to link or connect in a series. It is one example of 
an admittedly obscure SunOS reference. It refers to the fact that you can look at more than one file in a row by 
typing more than one filename after you type cat (see the section on looking at a file in this chapter). 

See Doing More with SunOS: Beginner’s Guide for information about listing hidden files. 
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Create a couple of files and look at them for practice. 

When you try to look at a nonexistent file with cat, it will type an error mes¬ 
sage. For example: 

Figure 4-3 Error: Trying to Look at a Nonexistent File 

- -- 

venus% cat nightmare 

nightmare: No such file or directory 
venus% 

V_^ 


You can also look at reaUy tortg files with cat. One long file is 
/usr/lib/units, which describes various units used in business and science. 
Don’t worry about the /’s in this filename. The section on pathnames later in 
this chapter will explain. 

When you cat a really long file, it wiU fly by on your screen until it finishes. 
Only the last screenful of the file will remain. 


Alwa ys reme mber to type (ctri-Q ] To prevent the file from “flying by,” type I Ctrl-S I while the system types out the 

after f Ctrl-5 j; otherwise, the system temporarily halt the system from typing. It wiU probably go by pretty fast 

won t respond when you type. „„ •' , ^ ^ .r . z-, 

anyway. When you want the system to start typing the rest of the file, type 

I Ctrl-01 . (That’s a Q, not an 5.) 

So, try it: 


Figure 4-4 Looking at a Long File With cat 




N 

venus % 

cat /usj^/lib/units 


/ dimensions 


m 

*a* 


kg 



sec 

★c* 


coul 

^d* 


.., and so on until the system ** hears* * you type 


( Ctrl-S 

3 f when it stops and waits for you to type 


1 Ctrl-Q 

D to resume displaying until the end of the file ... 


tun 

8 barrel 


water 

.2249112.54 kg/m2-sec2 


wey 

40 bu 


weymass 

252 lb 


Xunit, 

1.00202-13m 


k 

1.38047-16 erg/degC 


venus% 





y 


You may have noticed that cat isn’t particularly convenient for looking at long 
files. So, another way to look at files is with the program more. 
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The amount of text on a screen will 
vary with the size of screen you are 
using. 


Type more and the filename, more will type out only one “page,” or screen 
of text, then it will wait. When you hit the space bar, more types out the next 
page, and so on, until you reach the end of the file. 


Figure 4«5 Looking at a File with more 





Venus % XQore 

/usr/lib/units 


/ dimensions 

m 



kg 



sec 



coul 



candela 



dollar 

* 


radian 



bit 



erlang 



degC 



/ constants 

fuzz 



pi 

3.14159265358979323846 


c 

2.997925+8 m/sec fuzz 


g 

9.80665 m/sec2 


au 

1.49597871+11 m fuzz 


mole 

6.022169+23 fuzz 


e 

1.6021917-19 Coul fuzz 


energy 



force 



mercury 

1.33322+5 kg/m2-sec2 


hg 

mercury 


/ dimensionless 


degree 

1|180 pi-radian 


circle 

2 pi-radian 


turn 

2 pi-radian 


grade 

.9 degree 


|--More--(5%) 

Type the space bar to see more of the file 


V 

or type q,for quit, to stop looking at it. 



more tells you the percentage 
(rounded to nearest integer) of the 
file text it has typed onto the screen. 


more doesn’t let the file “fly by” like cat does, so more is especially good 
for looking at long files. 

Using more, look at the files you have created. 
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Printing a File You’ve created and looked at a file, now you can print one. To print the file 

alice.type Ipr and the filename, alice: 

Figure 4-6 How to Print Out a File 



Simple right? Sometimes, it’s not quite so simple. You may have to: 

□ Find out where the printer is, assuming there is a printer. 

□ Find out which of a few printers your file is printing on. 

□ Add paper to, or fix a paper jam in, the printer. 

□ Get someone to tackle a printer software problem. 

When something goes wrong, ask someone for help; when you can’t, see System 
and Network Administration. 

The result is a printout, or hardcopy, of your file. 

Listing Files To get a list of your files — eirana, which you create in this example, and 

alice, from example 4-1 —type Is (for “list”): 

Figure 4-7 Listing Files 



Is displays the filenames in alphabetical order. 


Moving (or Renaming) Files To rename one of your files, type mv (for ‘ ‘move’ ’) followed by the current 

filename and the new filename. For example, to rename the file alice as 
walker, type: 
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Figure 4-8 Moving and Renaming Files 



In the example. Is returns a file listing, indicating that the file was renamed suc¬ 
cessfully. 

When you try to mv a file that doesn’t exist, mv types an error message and 
doesn’t move anything: 

Figure 4-9 Error: Trying to Move a File That Doesn’t Exist 



When you try to mv a file onto an existing file, mv overwrites the contents of 
the target file with the contents of the file you are moving. For example, when 
you move the file walker onto the file emma, mv removes the contents of 
emma and replaces them with the contents of walker. In other words, the con¬ 
tents of the file emma disappear, replaced by the contents of the file walker. 

So, be careful when moving files onto other files. 


In the special case when you try to move a file onto itself, mv types an error message and doesn’t move 
anything: 

venus% mv walker walker 

mv: walker and walker are identical 
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Copying Files 


Figure 4-10 Caution; Moving a File to an Existing Filename 

-^ 

venus% Is 

emma walker 
venus% cat exnma 

**If I can't dancer I don't want to 
be part of your revolution,’’ 
venus% mv walker exnma 
venus% Is 
einma 

venus% cat emma 

”We reach for destinies beyond 
what we have come to know.” 
venus% 

V___ . _______> 


To copy one of your files, type cp (for ‘ ‘copy”) followed by the filename of the 
file you want copied and the filename of the file that is the copy. For example, to 
make a copy of the file emma, that copy called hurston: 

Figure 4-11 Copying a File 

( -^ 

venus% Is 

emma 

venus% cp emma hurston 
venus% Is 
emma hurston 
venus% cat exnma 

”We reach for destinies beyond 

what we have come to know.” 

venus% cat hurston 

”We reach for destinies beyond 

what we have come to know,” 

venus% 

s_> 


cp copies from the first file to the second. In this example, cp copies the con¬ 
tents of file emma into the new file hurston. Unlike mv, cp doesn’t remove 
the first file, but leaves it intact. 

Just as with mv, when you try to cp a file that doesn’t exist (void in the next 
example), cp types an error message and doesn’t copy anything: 
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Figure 4-12 Error: Trying to Copy a File That Doesn't Exist 


c 


venus% Is 


emma hurston 


venus% cp void existence 


cp: void: No such file or directory 


venus% Is 


emma hurston 


venus% 


V_ 

. ^ 


When you try to cp from one file to an existing file, cp replaces the contents of 
the target file with the contents of the file you are copying. For example, when 
you create a file called wilde, and copy it onto the file hurston, cp removes 
the contents of hur ston and replaces them with the contents of wilde. 

Unlike mv, however, the file wilde doesn’t disappear when cp copies its con¬ 
tents into the file hurston.^^ 

Figure 4-13 Caution; Copying a File to an Existing Filename 

- 

venus% cat > wilde 

"There id no such thing as a xxioral or an ixnmoral 
book. Books are well written or badly written. 

That is all." 

(Don't forget to end with 1 ctrl~D I .) 
venus % Is 

emma hurston wilde 

venus % cat hurston 

"We reach for destinies beyond 

what we have come to know,." 

venus % cp wilde hurston 

venus% Is 

emma hurston wilde 

venus% cat hurston 

"There is no such thing as a moral or an immoral 
book. Books are well written or badly written. 

That is all." 
venus % 

< _ > 


Removing (or Deleting) Files With all of these files around, it gets really messy. The rm command allows 

you to clean up by removing, or deleting, the files you no longer need. 

Take care in using the rm command. Once you rm something, you may never 
get it back.^^ If you wish to make rm a bit more cautious about removing your 


In the special case when you tiy to copy a file onto itself, cp types an error message and doesn’t copy 
anything: 

venus% cp hurston hurston 

cp: Cannot copy file to itself. 
venus% 
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files, see Setting Up Your SunOS Environment: Beginner’s Guide To remove a 
file, type rm followed by the jilename(s) of the file(s) you wish to remove. 
Since, after trying mv and cp, the files emma and hurston both contain 
quotations not said by them, to rm them type: 

Figure 4-14 Removing (or Deleting) a File 


r - 



venus% 

Is 


einma 

hurston wilde 


venus% 

rm emma hurston 


venus % 

Is 


wilde 



venus% 



^. 




Notice that you can remove more than one file at once by including filenames of 
aU the files you wish to remove after the rm command. Many of the SunOS 
commands accept more than one filename. 

When you try to rm a file that doesn’t exist, rm types an error message and 
doesn’t remove anything: 

Figure 4-15 Error: Trying to Remove a Nonexistent File 

- 

venus% Is 
wilde 

venus% rm gryphon 

gryphon: No such file or directory 
venus% 

V_ J 


4.3. Directories Just as a file is a container for text or programs, a directory is a container for 

files. You could think of a directory as a filing cabinet that can store files for 
you. You can create a directory to store all of the files for a certain project. 

Directories act as glue to link the SunOS file system together. Create, delete, and 
use them as you need them. 

Creating (or Making) To make a directory, type mkdir followed by the new directory name. For 

Directories example, to create the directory quot at ions: 


If you or your system administrator does backups of your file system, you may be able to retrieve deleted 
files. Contact your system administrator or look at System and Network Administration. 
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Figure 4-16 Creating (or Making) a Directory 




venus% mkdir quotations 


venus% Is 


quotations wilde 


venu3% 


V_ 

J 


When you list your files, you can see that the directories appear in the listing 
along with the files. In fact, directories are a kind of file — a file that can store 
other files, including other directories.^® 

When a file and a directory appear in a listing together, it does not mean that the 
directory contains the file; see the section on listing files in other directories in 
this chapter. 

When you try to mkdir a directory that already exists, mkdir types an error 
message and doesn’t make any directories: 

Figure 4-17 Error: Trying to Create an Existing Directory 


r 


venus % Is 


quotations wilde 


venus% mkdir quotations 


mkdir: quotations: File exists 


venus % 


.. 



Removing Empty Directories To remove empty directories, in other words, directories that don’t contain files 

or other directories, use the rmdir command. For example, to remove the 
directory quotations: 


Figure 4-18 


Removing an Empty Directory 



You can remove more than one directory at a time by typing rmdir followed 
by the directory names of aU of the directories you want to remove. 


Removing Non-Empty When you try to remove a directory that contains some files or directories. 

Directories rmdir types an error message and doesn’t remove anything. For this example, 

assume that directory bloated contains files or directories. 


^ If you want to be able to distinguish easily your directories from your files when you list them, see the 
section on using an option to 1 s in Chapter 10 . 
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Figure 4-19 Error: Trying to Remove a Directory and Its Contents with rmdir 



Removing Non-Existent When you try to remove a directory that doesn’t exist, rmdir types an error 

Directories message and doesn’t remove anything: 

Figure 4-20 Error: Trying to Remove a Nonexistent Directory 



Removing Something That Isn’t When you try to rmdir a file that isn’t a directory, rmdir types an error mes- 
a Directory sage and doesn’t remove anything: 

Figure 4-21 Error: Trying to Remove a File With rmdir 



To remove a directory that contains files or directories, see the section on remov¬ 
ing directories and their contents later in this chapter. 

Moving and Copying Files to Now that you know how to make directories, you may want to store some files in 

New Directories them. You can mv and cp files into your directories. 

Note: Hoxlcexhe underscore charac- Make a directory f amous^people and a file actresses, and move the 

ter in the directory name new file into the new directory by typing mv followed by the filename and the 

famous_peopie. directory name: 


^sun 

Xr microsystems 
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Figure 4-22 Moving a File into a Directory 



Notice that the file you moved into the new directory does not show up when you 
list your files. To see it, you will have to list the files in that directory (see the 
section on listing files in other directories later in this chapter). 

But, for now, be confident that you have moved the file actresses into the 
directory f amous_people, as shown in this diagram: 

Figure 4-23 Effects of Moving a File into a Directory 



Next, let’s create a new file actors and copy it into the directory 
f amo u s_j) e op 1 e: 
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Figure 4-24 Copying a File into a Directory 



The file actors appears in your list of files, but a copy of it is in the 
f amous_people directory too. 


Figure 4-25 Effects of Copying a File into a Directory 



mv and cp wiU give the same error messages as before when you try to move 
and copy from nonexistent files, or onto existing files. 



Revision A of 9 May 1988 





36 Getting Started with SunOS 


Listing Files in Other To list the files in other directories, type Is followed by the directory name of 

Directories the directory you want to list: 

Figure 4-26 Listing the Files in Another Directory 



The file actors appears in the both listings because you copied it into the direc¬ 
tory famous_people. 

When you list the files in a directory that has no files, 1 s doesn’t list any files. 
Notice that no two files in the same directory can have the same filename. 

When you try to list the files in a nonexistent directory, 1 s types out an error 
message and doesn’t list anything: 

Figure 4-27 Error: Trying to List a Nonexistent Directory 



When you list a file, rather than a directory, 1 s types out the filename of that 
file: 


Figure 4-28 Listing a File, Not a Directory 


/■ - 

venu3% 

Is 

N 

actors 

famous_people 

wilde 

venus % 

Is wilde 


wilde 



venus% 

V_ 


.> 


Moving (or Renaming) 
Directories 


Since it is possible to move and copy files, why not move and copy directories? 

To move (or rename) a directory, type mv followed by the old directory name 
and the new directory name. For example, to move the directory 
famous_j)eople into the directory film, people: 


msun 

XT microsystems 
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Figure 4-29 Moving (or Renaming) a Directory 

- 

venus% Is 

actors £amous_people wilde 

venus% mv £aiDous_j>eople film.people 
venus % Is 

actors film.people wilde 

venus% Is film.people 
actors actresses 

ventis% 

__ 


You may have wondered why the command for renaming files and directories is 
mv, rather than perhaps rn, for ‘ ‘rename.’ ’ The reason is that you can actually 
move one directory into another directory. The directory that you move into the 
other directory is a subdirectory of that directory. Extending the analogy of 
directory as filing cabinet, you could think of a subdirectory as one drawer of the 
filing cabinet. 

Make a directory and move or copy files into it Then, move the directory into 
another directory by typing mv followed by the directory name of the directory 
you want to move (with its contents) and the directory name of the directory into 
which you want to move it. For example: 

Figure 4-30 Moving a Directory into Another Directory 

- 

venus % xtikdir directors 
venus% cat > spielberg 
Jaws 

Close Encoxinters of the Third Kind 
E.T. 

Back to the Future 

The Color Purple (Don't fon^et to end with 1 Ctrl-D L ) 
venus% mv spielberg directors 
venus% Is 

actors directors film.people wilde 

venus% Is directors 

spielberg 

venus% Is film.people 
actors actresses 

venus%mv directors film.people 

venus% Is 

actors film.people wilde 

venus% Is film.people 

actors actresses directors 

venus% 

_ V 


Remember that the file spielberg is not in the directory directors when 
you create it. For now, a file won’t appear in a directory you’ve created until you 
explicitly move it there. 
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When you try to move a directory into a file, mv will type an error message and 


Figure 4-31 

won’t move anything: 

Error: Trying to Move a Directory into a File 



venus% mv film.people wilde 

mv: film.people: rename: Not a directory 
venus% 

\ 


k ^_ 

y 


The system checks to make sure you don’t move a directory into a file, so the 
system won’t remove the file when you try to move a directory onto it. 


Removing Directories and When you want to remove a directory and its contents, the easiest way is to type 

Their Contents rm -r and the directory name of the directory you want to remove. For exam¬ 

ple, to remove the directory f ilm. people and its contents; 

Figure 4-32 Removing a Directory and Its Contents 





venus % 

Is 


actors 

film.people 

wilde 

venus% 

rm -r film.people 


venus% 

Is 


actors 

wilde 


venus% 



V_ 


___✓ 


The -r in rm -r is an option to the rm command. Learn more about options 
in the section on options in Chapter 5 . The -r option to rm causes rm to exe¬ 
cute recursively, that is, rm removes the file or directory you specify, the con¬ 
tents of the directory you specify, the contents of that directory, and so on. 

Be especially careful about using rm -r, especially in combination with the 
special character *, because you may delete files and directories that you intend 
to save. 


Changing Working When you list files, move or copy files into another directory, and list the files in 

Directories that directory, you may have wondered: Where did I start out? Where am I mov¬ 

ing and copying these files from? 

The answer is: When you first log in, you are in a special directory called your 
home directory. In fact, every time you log in you wiU start out in your home 
directory. 

So far, you have done all of your work while in your home directory. But you 
can change directories to do woik in other directories too. 


Current Working Directory The directory in which you are working is your current directory, or your work¬ 

ing directory. To change your working directory from your home directory to 
one of the directories you have created, type cd and the directory name of the 
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directory you want to become your working directory. For example, to change 
directories from your home directory (where you are now) to a newly-created 
directory hinterland: 

Figure 4-33 Changing Your Working Directory 


f 




venus% 

xnkdir hinterland 



venus% 

Is 



actors 

hinterland 

wilde 


venus% 

Is hinterland 



venus% 

cd hinterland 



venus% 

Is 



venus% 




V. 



.> 


As you can see, when you list the files in your woiidng directory, you get a list of 
the files (in the case of hinterland, none) in the directory you changed to. 

You can type any of the other commands you have learned in this new working 
directory, just hke when you’re in your home directory. Try it! 


Getting to Your Home You can get back to your home directory at any time by typing cd, without a 

Directory directory name. So, don’t worry when you get lost in a maze of files and direc¬ 

tories, you can always return home with cd. For example, when you are in the 
empty directory hinterland, type cd and you will return to your home 
directory: 

Figure 4-34 Changing Directories Back to Your Home Directory 


---- 

ventis% Is 
veniis% cd 
venus% Is 

actors 

hinterland 

wilde 

'N 

venus% 



J 


You can also travel into other user’s directories, directories accessible by groups 
of users, and directories used to maintain the system. If you travel outside of 
your own directories, do not modify the files and directories you find there, 
unless you are absolutely sure you should do so. 


4.4. The File System All of the files and directories on the system form the^fe system hierarchy. This 

Hierarchy hierarchy has a tree structure. Somewhat paradoxically, at the “top” of the tree 

is the root directory. The root directory is the parent directory of its subdirec¬ 
tories, or child directories. Each of the subdirectories acts as a parent directory 
to its own child directories (if it has any directories “below” it) throughout the 
tree stmcture. 
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What Directory Is This? 


The big advantage of the SunOS file system is that you can customize the stmc- 
ture of files and directories to meet your own needs. 

To find out what the actual Sun file system hierarchy on your system looks like, 
see the description of the hier Man Page in Setting Up Your SunOS Environ¬ 
ment: Beginner’s Guide. 

At times, it is useful to know where you are in the file system hierarchy — that 
is, what directory is your woridng directory. 

To find out your working directory, type pwd (for ‘ ‘print working directory’ ’); 
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Figure 4-36 How to Find Out Your Working Directory Name 


r 


venus% pwd 


/home/medici 


venus% cd hinterland 


venus% pwd 


/home/medici/hinterland 


venus% cd 


venus% pwd 


/home/medici 


venus% 


V_ 



Notice how cd, without a directory name, returns you to your home directory. 

Don’t worry if your working directory doesn’t look like the working directory in 
this example. You have to understand pathnames, explained in the next section, 
to make sense of it all. 


Pathnames: Relative and 
Absolute 


Some logical questions to ask at this point are: 
o Why does pwd give me such a strange working directory name? 
□ What is this bizarre thing with all the slashes? 


Although home directory path¬ 
names are fairly standard, you or 
your system administrator may 
modify the file system so that your 
home directory appears in a dif¬ 
ferent portion of the hierarchy. 


Since your home directory is part of the file system hierarchy, it occupies a cer¬ 
tain place in that hierarchy. SunOS uses pathnames, or branches, with a certain 
notation, to indicate a location in the hierarchy tree. 

There are three kinds of pathnames: simple, absolute, and relative. When you 
learn to choose the right type of pathname for the task, your work becomes 
easier. 

So far, you have typed only simple pathnames. Simple pathnames are file or 
directory names that don’t include any complex information about position of the 
file or directory within the file system hierarchy. So, when you type cd 
hinterland, hinterland is a simple pathname, cd takes hinter¬ 
land to mean the directory hinterland that is a child of the working direc¬ 
tory. 

Absolute pathnames indicate the absolute position of a file or directory within the 
hierarchy. They begin with the slash character, /, denoting the root directory of 
the entire file system. The absolute pathname tells you “how to get there from 
the system root directory.’’ 

The root directory has a child directory called home. The usual home directory 
pathname of user medici on workstation venus is /home/medici. 
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Figure 4-37 Absolute Pathname of Home Directory 



Absolute Pathnames The absolute pathname traces the absolute position of a file or directory in the file 

system hierarchy. It starts with a / to represent the root directory, followed by 
its child directory and another / to separate the name of the child directory from 
the name of its own child, and so on. 

Note: Don’t be confused by the two meanings of /: it’s both the name of the root 

directory and a separator in pathnames. 

Another way to change directories to your home directory is to type cd followed 
by the absolute pathname of your home directory (although typing cd alone is 
more efficient): 

Figure 4-38 Using the Absolute Pathname of Your Home Directory 



Relative Pathnames Relative pathnames differ from absolute pathnames in that they don’t provide an 

absolute path within the file system hierarchy. They don’t trace the file or direc¬ 
tory position from the root directory down through its children and their children 
until the desired file or directory. 

Instead, relative pathnames trace the path from the woricing directory to the 
desired file or directory, or “how to get there from here.” They are most useful 
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when trying to get from one file or directory on a branch to another file or direc¬ 
tory on that branch. 

To experiment with relative pathnames, construct your own little tree of files and 
directories. Do something like this: 

Figure 4-39 Setting Up a Tree of Files and Directories 

venus% pwd 
/home/medici 
venus% cd hinterland 
venus% xnkdir asia 
venus% mkdir north.axnerica 
venus% cd north.axnerica 
venu3% xnkdir united«states 
venus% cd tinited.states 
venu3% cat > alaska 

Alaska is the largest state in the United States. 

(Don t forget to end with ( ct rl-D ) .) 
venus% cd 
venu3% pwd 
/home/medic i 
venu3% 

v_ 
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Here’s what the file and directory tree looks like: 


Figure 4-40 A File and Directory Tree 



To access a file or directory from another directory, it is not necessary to be in 
that directory or its parent, or to specify the absolute pathname. In fact, if one 
had to use only simple or absolute pathnames all the time, some situations would 
require a lot of typing and inconvenience. 

When accessing a distant file or directory, the relative pathname permits you to 
specify only those parts directly on the path between your current location and 
the location of the object you want to access. 

So, in our example tree structure, to cat the file alaska from the working 
directory hinterland, type cat followed by the relative pathname of the 
file in relation to the woiking directory: 
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Figure 4-41 Using Relative and Absolute Pathnames to Look at Files 



In the above example, Is uses the absolute pathname of the directory, and cat 
uses the relative pathname of the desired file in that directory. Qearly, the rela¬ 
tive pathname is more convenient in this instance. 


Abbreviations for Special Because they get typed so often, special directories, such as the home directory. 

Directory Pathnames current directory, and parent directory, have abbreviated notations for their path¬ 

names. 

Home Directory Abbreviation You can specify your home directory pathname as the tilde character, or ‘ ‘squig- 

gle”: ~. When you are busy in a working directory somewhere distant in the 
tree structure and you want to list the files in your home directory, you can use 
the ■ abbreviation. Substitute ~ for the specification of your home directory 
pathname: 

Figure 4-42 Abbreviation of the Home Directory in a Pathname 



The advantage of using the abbreviation is that you type fewer characters and 
you can remain in your working directory where you may have easier access to 
the files and directories you’re working on. 
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You can access other user’s home directories by typing the tilde character, fol¬ 
lowed by that person’s username. So to connect to user pandora’s home direc¬ 
tory, type cd "pandora: 

Figure 4-43 Abbreviation of Other User’s Home Directories in a Pathname 



The next example is difficult, but persist and you will understand. 

Working Directory 
Abbreviation 


Figure 4-44 Abbreviation of the Working Directory in a Pathname 
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You can specify the woridng directory pathname as the dot (.). This abbrevia¬ 
tion is useful in a variety of situations. For instance, when you want to copy a 
file from a distant directory in the file system hierarchy into your working direc¬ 
tory, you can type cp followed by the pathname of the file and the working 
directory abbreviation (.): 
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Here’s what the tree looks like after copying file alaska: 


Figure 4-45 File and Directory Tree Modified by File Copying 



Parent Directory Abbreviation You can specify the pathname of the parent directory of the working directory as 

two consecutive dots (. . ). As with the other abbreviations, this abbreviation 
makes it easier to get certain things done. For example, to move a file from your 
working directory into its parent directory, type mv followed by the filename of 
the file you want to move and the abbreviation for the file’s destination, the 
parent directory (. . 
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Figure 4-46 Abbreviation of the Parent Directory in a Pathname 


venus% pwd 

/home/medici/hinterlanci 
venus% Is (Notice the squiggle here.) 
actors hinterland wilde 

venus% Is 

alaska asia 


venus% mv alaska 
venus% Is 


north.america 
(Notice the two dots here.) 


asia 

venu5% Is ♦* 
actors 
venus% cd 
venus% pwd 
/home/medici 
venus% 


north.america 
(Notice the two dots here.) 
alaska hinterland 


wilde 


Here’s what the tree looks like after moving file alaska: 
Figure 4-47 File and Directory Tree Modified by File Moving 



Key 


^ directory ^ 


♦ 



file 


alai 

!_ 

ska 


Notice that two abbreviations may serve the same purpose, as with the listing of 
the parent directory, that happened to be the home directory in the example 
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above. 

Perhaps the most common use of the parent directory abbreviation is to change 
directories into the parent directory of your working directory. 

Figure 4-48 Changing Working Directory Into Parent Directory 

- 

veinis% pwd 
/home/medic i 

venus% cd hinterland/north.america 

venus% pwd 

/home/medici/hinterland/north.america 
venus% cd ♦ > (Notice the two dots.) 
venus% pwd 

/home/medici/hinterland 
venus% 

V_^_ 

4.5. Brief Review Here is a table that provides a brief review of the last two sections (assume that 

your working directory is /home/medici/hinterland when pertinent): 


Table 4-1 Directory Types and Abbreviations 


Syntax 

Definition 

Example 

directoryjiame 

simple directory name 

north.america 

rootjdirectorylchildichildl ... 

absolute directory name 

/home/medici/hinterland/north.america/united.states 

child_directoryf child!... 

relative directory name 

north.america/united.states 

~ 

home directory 

/home/medici 

. 

working directory 

/home/medici/hinterland 


parent directory 

/home/medici 


You’ve learned a good deal about the file system. If you want it, you deserve a 
break at this point, so you’re refreshed to start out the discussion of commands in 
the next chapter. 
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Commands 


You type commands to tell the system what to do. In past chapters, you learned 
commands like cat, cp, and mv. In this chapter, you will learn the stmcture 
of commands, so that you can understand many more of them without learning 
all of the structural details each time. 


5.1. Command Grammar Since you’ve been using some commands, you may have noticed that commands 

have a certain grammar. One could draw an analogy between SunOS command 
syntax and English, or other natural languages?^ 


Technically, the command is part of 
a command line that includes the 
command and its options, 
filenames, and other expressions. 


All parts of SunOS command lines correspond to English parts of speech. A 
command line consists of the actual command and its arguments, the rest of the 
command line. The command is similar to a verb. Of the arguments, options are 
similar to adverbs, and filenames or other expressions are similar to objects of the 
verb.^^ 


Two Simple Commands date is a useful command that types the current date and time associated with 

your geographical location.^ 

If you decided to ask for the current date and time at the stroke before midnight 
on New Year’s Eve of the year 1999, you would type date: 

Figure 5-1 The date Command 


f 

A 

venus% date 


Fri Dec 31 23:59:59 PST 1999 


venus% 


V . . 

.-. J 


PST is an abbreviation for Pacific Standard Time, from the time zone in which 
this manual was written. To get the Greenwich Mean Time, or universal time, 
type the command date, followed by the option -u: 


Natural languages are languages that people connnonly speak, read, or write within a society or culture. 

^ Interestingly, the noun as subject of the SunOS “sentence” doesn’t exist. One may assume that com- 
mands are interrogative, so it isn’t necessary to preface commands with “you,” meaning the system. 

Don’t ask what happens in outer space! If your date and time don’t reflect the appropriate date and time 
for your location, contact your system administrator or see System and Network Administration. 
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Figure 5-2 The date Command with Option for Universal Time (GMT) 



Another useful command, cal, has one required argument, one optional argu¬ 
ment, and no command options. The required argument is the year for which 
you want to constmct a calendar. The optional argument is the month. So, you 
can construct a calendar for the whole year of 2001 by typing: 
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Figure 5-3 Constructing a Yearly Calendar 



To construct a calendar for a specific month, type the number of the month and 
the year. 


Figure 5-4 Constructing a Monthly Calendar 



^sun 

Xr microsystems 
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Type Ahead or Read Ahead 


Figure 5-5 


Commands as Verbs 


Options as Adverbs 


Filenames as Objects 


(Try September 1752.) 


SunOS has an interesting feature called type ahead or read ahead. Type ahead 
allows you to type new commands while the system is executing the current 
command. When you know that you want to type several commands no matter 
what the outcome of each command, you can type ahead and the system will exe¬ 
cute each command in order as it completes the previous command. 

Type ahead is most useful when the system requires a lot of time to complete 
execution of a command. For example, it usually takes the system a bit of time 
to execute the Ipr command. You can type Ipr (followed by I Return I ). then 
Is, without waiting for the system to print the command prompt that signals 
completion of the Ipr command. This is what it looks like: 


Type Ahead or Read Ahead 


r 




venus% 

Is 



actors 

alaska 

hinterland wilde 


venus% 

Ipr wilds 



Is 




ventis% 

actors alaska 

hinterland wilde 


venus% 




V_ 



_✓ 


One side effect of type ahead is that the system types out the results of the Is 
command just after the command prompt that occurs between the Ipr com¬ 
mand and the 1 s command. That looks funny because the (Return I that you 
pressed after Is appears directly after Is, not after the command prompt. 


As mentioned above, commands are the “verb” of the command line. Some 
commands have no arguments, many have optional arguments (like the cal 
command’s optional month argument), and some require arguments to execute 
without an error (Ipr requires a filename argument). 


An option is one possible argument to a command. The option, sometimes 
known as a flag, tells the command to execute in a certain way. For instance, the 
date command, with its -u option, types the Greenwich Mean date and time, 
rather than the local date and time. 

Usually, a - precedes the option to a command. - is a marker for options, 
and precedes most options on the command line. 


Some commands accept filenames as arguments, or “objects,” in the command 
line, cat, for example, types out the file contained in its filename argument. 


Asun 

Xr microsystems 
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Putting the Grammar 
Together 


Is is an example of a command with options and filename arguments. When 
you want to list the files in directory hinterland, with the files appearing 
from most recent file modification to oldest time of modification, use the -t 
option to Is; 


Figure 5-6 Command with Option and Filename Argument 

venus% Is -t hinterland 

north.america asia 
venus% Is hinterland 
asia north.america 

venus% 

^_J 


Because you created the directory north. america after creating the direc¬ 
tory asia, north, ame r i c a appears first in the file listing when using the 
-t option, and last in the file listing without the option. 

To make it absolutely clear. Is is the command, -t is the option, and 
hinterland is the filename (for a directory) in the above example. Options 
usually appear before other arguments in the command line. 


5.2. Wild Card Characters At the end of Chapter 4 on flies and the file system, you learned abbreviations for 

the home directory, the working directory, and the parent directory. Sometimes, 
you can abbreviate filenames too, using certain special characters called wild 
card characters. 

The most common wild card characters are: ? and * . ? is the wild card 

character representing a one-character value; * represents an arbitrary number 
of characters. 

For example, when you want to list all of the files that begin with any two char¬ 
acters and end with a certain string, or character combination (in this case 
tutors): 

Figure 5-7 Use of ? Wild Card Character 

- 

venus% cat > tutors 
Socrates 

Voltaire (Don’t forget to end with a LCturl-P.J .) 
venus% Is 

actors alaska hinterland tutors wilde 

venus% Is ??tors 
actors tutors 
venus% 

V. . . > 


When you want to list aU of the files that contain the string la: 


microsystems 
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Figure 5-8 Use of * Wild Card Character 

Note: Is labels the files it lists in the 
directory hinterland with the 
directory name, so that there is no con¬ 
fusion about the listing. 


(Note that asia and north. america are shown, even though they don’t 
match the pattern given, because the directory which contains them— 
hinterland—does.) 

These wild card characters are especially useful when you have to search through 
large directories full of files. The wild card character *, when used by itself, 
matches aU the files in a directory. For example, to copy all the files in the 
current directory into the directory /tmp, you would type: 

Figure 5-9 Matching All Files With * 




5.3. Redirecting Output When you created your first file in the section of Chapter 4 on creating files, you 

used a technique called redirecting output, or sometimes output redirection, 
without really knowing what you were doing. 

You typed cat > alice followed by the quotation you inserted into the file. 
By typing the > symbol, you “redirected” the output from the cat command 
into the file alice. 

In other words, when you type > after a command, you redirect the output of 
that command into the filename after the > symbol. You’re telling the system to 
take what a command would have typed out to the screen and put it into a file 
instead. 

You can also redirect the output of spell, a program that checks your spelling. 
First, create a file full of spelling mistakes with cat by redirecting the output of 
cat to place it in the file mispell. Then, run spell on the file mispell, 
redirecting the output from spell into the file errors. 


#sun 
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Figure 5-10 Spelling Correction and Redirecting Output 



spell finds the spelling errors in a file and types them in alphabetical order 
As in the above example, redirecting the output firom spell into a file allows 
you to store the spelling errors until you no longer need to refer to them. 


Be careful when redirecting the output of a command to a file. When you 
redirect output onto a file that already exists, the output redirection will remove 
the current contents of that file and replace them with the redirected output. You 
could lose some valuable work.^ 

Figure 5-11 Caution: Redirecting Output Onto an Existing File 



Appending Redirected Output You can avoid “writing over” the contents of a file by appending output onto 

the file, rather than replacing the file. So, if you want to add the date to the end 
of a file, use the append redirecting output symbol » . 


^ This file is a quotation from The Elements of Style, third edition, by William Stnink, Jr., and E.B. White. 

^ To prevent redirected output from “clobbering,” or replacing the contents of your files, see the section on 
the noclobber environment variable in Setting Up Your SunOS Environment: Beginner’s Guide . 
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Figure 5-12 Appending Output to a File 


......... 

venus% Is 

actors alaska hinterland tutors wilde 


venus% cat actors 

Paul Muni 

Humphrey Bogart 

venus% date » actors 

venus% cat actors 

Paul Muni 

Humphrey Bogart 

Mon Sep 14 10:00 PST 1936 

venus% 

_J 


When you append output to a file that doesn’t exist, the append output symbol, 

» , acts exactly hke the first redirecting output symbol, > , creating the file and 
redirecting the command output into it. Try duplicating the example in Figure 
5-10, describing spelling correction and redirecting output, by removing the file 
error, then replacing the redirecting output symbol, > , in the example, with 
the append output symbol, » . 


5.4. Interactive Programs So far, the distinction between a command and a program is blurry. But one kind 

of program, called an interactive program, is never called a command. 

An interactive program is a program that expects further instructions after it 
begins executing. 


be may be picky about requiring 
spaces around arithmetic operators. 


be, the basic calculator program, is an interactive program. To begin execution 
of be, type be. Then, type basic arithmetic expressions, each followed by 
I Return I . and be will type out the result of the arithmetic calculation. Use any 
of the following arithmetic operators: + for addition, - for subtraction, * for 
multiplication, and / for division. The i Return I acts as an equals sign. To quit, 
or stop execution of be, type I Ctrl-D I on a line by itself. 


Figure 5-13 Basic Calculations with be 

-- 

venu3% be 

3 + 7 

10 

3-7 

-4 

3*7 

21 

3/7 

0 (To quit, type I ctrl-D I on next line.) 
venus% 

.. .. .. . 


As you can see, be types out results with a certain number of decimal places. 
When you want be to type results with more decimal places, type seale = 
followed by the number of decimal places you want. 
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Figure 5-14 Changing Scale in be 



be offers a variety of other mathematical functions, base conversion, and vari¬ 
able assignment and manipulation.^^ 


You’ve learned a lot about commands in this chapter, and you’ve encountered 
interactive programs. One of the most frequently used interactive programs on 
the system is mail. See Mail and Messages: Beginner’s Guide for more infor¬ 
mation. Another widespread interactive program is vi, the SunOS text editor, 
described in the next chapter. 
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Editing Files 


In previous chapters, you created files and sometimes even altered them. To 
create and make changes to most files, however, it is more convenient to use an 
interactive program, a text editor. The standard SunOS text editor is vi (the 
“visual editor”). 

6.1. Creating a File To create a file using vi: 

□ Start vi 

□ Add text to the file 

□ Write the file to save its contents 

□ Quit, or stop using, vi 


Starting vi 


Choose a name for the file you want to create, and type vi followed by the 
filename. So, to create the file malleable: 

Figure 6-1 Starting vi with a filename 
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After a short wait, vi erases the screen and types out its own interactive screen. 


Figure 6-2 vi Interactive Screen 


Because vi fills up its screen or 
window, it displays tildes (~) for 
lines which are not part of the file 
being edited. This way you can tell 
a blank line in the file from screen 
space which comes after the end of 
file. 



The last line of the interactive screen shows the filename and indicates that you 
are creating a new file. It is called the status line. 

You can also start vi without a filename by typing just vi. In this case, the 
interactive screen looks like this: 


Figure 6-3 


vi Interactive Screen Without filename 
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Adding Text To add text to the file, type a, for append or add, followed by the text you want 

to put into the file. The a won’t show up on the screen or become part of the 
file; it is an instruction to vi. 

When you type a, you switch from vi's command mode to the insert mode, 
allowing you to enter text into the file. You can type as many lines of text as you 
want. Type [ Return 1 at the end of each line of text. 


Note: You must explicitly exit insert 
mode with I Esc 1 . otherwise vi 
assumes you are still attempting to 
enter text. Figure 6-4 



When you’re finished entering text into the file, type [Esc 1 to “escape,” or exit 
from insert mode. The cursor moves back onto the last character added. 

Adding Text in vi 


Writing a File: Saving Your Once you finish adding text to a file, you can save your woiic, so that when you 
Work access the file again, the text you added will still be there. 


Note: In contrast to insert mode, 


you don’t explicitly exit vi colon 
mode. Rather, you exit colon mode 
automatically when you type 


To save your work, type a colon (:) to enter vi colon mode, then type w to 
“write” the file.^^ 


^ Make sure that you exit insert mode by typing I Esc ) before typing a colon to enter colon mode. 
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Figure 6-5 Writing (or Saving) a File in vi 



After you type 1 Return 1 . vi confirms that it has written the file by typing the 
filename, the number of lines in the file, and the number of characters in the file. 

Figure 6-6 vi Confirms Writing a File 



Quitting vi 


Now that you’ve written the file, you can safely quit vi. Type : to enter colon 
mode, and q to quit the vi program. 


^sun 

Xr microsystems 
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Figure 6-7 Quitting vi 



The system will type the command prompt to indicate that you have successfully 
quit vi. 

When you decide to quit vi without writing a file to which you have added or 
changed text, vi will refuse to let you quit. To demonstrate, add some more 
text to the example file malleable, then try to quit without writing the file. 

Figure 6-8 Caution: Trying to Quit vi Without Saving Changes 



When you really do want to quit without saving your changes, type : to enter 
colon mode and q! (an abbreviation for quit! that vi indicated in the mes¬ 
sage above). When you do this, vi will quit without saving your changes; the 
next time you access the file, the changes won’t appear. 


f#sun 

Xr microsystems 
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6.2. Moving Around Instead of typing an entire file over again when you save it with some mistakes, 

Within a File you can edit portions of the file to correct errors, or to make additions or dele¬ 

tions. 

However, to access different parts of the file, you have to be able to move around 
within it. Four commands, for each of four possible directions, allow you to 
move around a file. They are: 

h to move left, or ‘ ‘ west, ’ ’ one character on the screen 
j to move down, or ‘ ‘ south, ’ ’ one line on the screen 
k to move up, or ‘ ‘north, ’ ’ one line on the screen 
1 to move right, or “ east, ’ ’ one character on the screen 
These keys are located in a row on the keyboard. 

Figure 6-9 Cursor Moving Keys for vi 
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When you have a keyboard that has arrow keys, pointing left, right, up, and 
down, you may be able to use the arrow keys to move around in the file, in addi¬ 
tion to the h, 1, k, and j keys. Arrow keys looks something like this: 
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Figure 6-10 Arrow Keys 



A 

/ \ 

up 

left ^ 

/ \ 


right 

L _ S 

down 

Y 

/ \ 



You can move around the file only when you are in command mode. Once 
again, command mode is the mode you are in when you start vi, and when you 
are in neither text nor colon mode. 

Now, type vi malleable to work on the file created earlier in this chapter. 
This time, the vi status line won’t specify [New f ile ], because malle¬ 
able isn’t a new file anymore. You should see this on your screen: 

Figure 6-11 Starting vi with an Old File 


/- --- 

\ 

0s you add text. 


the lines with tilde characters 


will scroll down toward 


the bottom of the screen. 


"malleable” 4 lines, 99 characters 



j 


Notice that the cursor, indicating your current position in the file, is just over the 
letter A, the first character in the file malleable. When you type h, the 
system flashes the screen (or beeps) and refuses to move the cursor. That is 
because it can’t move the cursor to the left any further. 


microsystems 
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When you type j though, the cursor moves down one line onto t, the first 
letter of the next line. 

Figure 6-12 Moving Down in vi 



To move right one character from the letter t to the letter h, type 1. 
Figure 6-13 Moving Right in vi 


To move up one line from the letter h to the letter s, type k. 



^sun 

Xr microsystems 
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Figure 6-14 Moving Up in vi 



Finally, to move left one character from the letter s to the letter A, type h. 

Figure 6-15 


6.3. Editing a File 


Revision A of 9 May 1988 



Moving Left in vi 



Now, you can move in all four directions within a file. Experiment by moving 
around to various points in the file. 


There are a few different ways you can edit a file. You can change one portion 
of text to another character string, and insert text into or delete text from a certain 
place in a file. 
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Changing Text Three basic commands allow you to change text in the file: 

s to substitute a string for the character under the cursor 

cw to change a word, substituting a string for the portion of a word imder and 
after the cursor 

cc to change an entire line, substituting it with a string that you type 

You can access these commands from vi command mode; while using them, 
you are in insert mode. For each command, you exit insert mode by typing I Esc I 
when you are finished making changes. 

Substituting a String To substitute a string for the character under the cursor, type s. The screen will 

look like the figure below. Then, type in the string with which you want to 
replace the A character, say As soon a. followed bv I Esc I to exit from insert 
mode. 

Figure 6-16 Changing Text in vi; During the s Command 



The end result looks like this: 
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Figure 6-17 Changing Text in vi; After the s Command 



Changing a Word The cw worics the same way, except the substitution symbol $ appears on the 

last character of the word you are changing. Type h four times to move left 
onto letter o, the second character in the word soon. Then, type cw. 

Figure 6-18 Changing Text in During the cw Command 



You can type in the text you want to substitute for the rest of the word, say 
lowly, followed by I Esc 1 to exit insert mode. You can see the changes made to 
the first line in the next figure, illustrating the cc command. 

Changing a Whole Line The cc command is similar to sand cw, except that it replaces an entire line 

of text, and it doesn’t use the substitution symbol $ . Move to the second line of 
text by typing j , and to the beginning of that fine by typing h repeatedly. Then 
type cc to substitute for an entire fine of text. 


^sun 
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Inserting Text 


Figure 6-19 Changing Text in 'jx: During the cc Command 


r 

> 

As slowly as you add text. 


■ 


will scroll down toward 


the bottom of the screen. 


"malleable” 4 linesr 99 characters 


V___ 

_^ 


Type the string that you chose as a replacement to the deleted line, say the 
subsequent text, then type I Esc I to exit from insert mode. 


You can insert text with three basic commands: 
i to insert text under the cursor 
o (lower-case letter o) 

to insert text on a new line created just after the current line 
0 (upper-case letter O) 

to insert text on a new line created just before the current line 

Just as with the changing text commands, you access these commands from vi 
command mode. While using them, you are in insert mode. For each command, 
you exit insert mode by typing I Esc 1 when you are finished making changes. 

The next example shows the i command, but you should also try the other 
inserting text commands: o and 0. 

Move to the space between down and toward using a combination of h and 
j commands. Type i, a space character, then the text quickly under the 
cursor. Then type I Esc I to exit from insert mode. You should see something like 
this: 
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Deleting Text 


Figure 6-20 Inserting Text in vi; The i Command 

' > 
As slowly as you add text, 
the subsequent text 
will scroll down quickljj toward 
the bottom of the screen. 


"malleable" 4 lines, 99 characters 

V-jjSBjSagHSHaSigga ................. . 


The three basic commands for deleting text differ from the text changing and 
inserting commands because they don’t use insert mode. You are in command 
mode the entire time when you are deleting text. 

The three commands are; 

X to delete the character under the cursor 

dw to delete the portion of a word under and after the cursor (including the 
space after the word) 

dd to delete the entire line the cursor is on 

The following example shows the x command, but you should try the other 
deleting text commands, dw and dd, on your own. 

Move to the letter win the word toward. Type x four times, deleting the 
string ward. Don’t type I Esc) : you aren’t in insert mode, because deleting text 
commands use base mode. 
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Figure 6-21 Deleting Text in vL:The k Command 



When you delete a line of text with dd, vi erases the status line from the 
screen, imtil you write the file again. 


6.4. Where to Find Out Now you know the basics of vi, you can find out about the many other useful 

More About Editing vi commands, by looking at Editing Text Files. 

Files 
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Formatting Documents 


Sometimes it is a lot of work to create a file and print it out the way you want it 
to look. A text formatter allows you to specify concisely the way you want your 
printout to look, and to add special attributes, like different font sizes, intensities, 
and types, that would be impossible to access without the formatter. 

In this chapter, you will learn the basics of the SunOS formatter called 
nrof f 

To learn nrof f, you can create a sample memo which can act as a template for 
memos that you want to create in the future. Here is the sample memo, after for¬ 
matting: 


From: Board of Directors 
To: Vociferous Employees 
Cc: An Employees 


Cut Paper Waste on Memos 

It has come to our attention that certain employees of this company have been 
printing inordinate numbers of inter-office memos. As you know, our distinctive 
Flying Headstone stationery is quite expensive. 

We have decided to take three immediate steps to counter this threat to corporate 
profitability: 

1) We win reduce paper stocked for the printers by 25% within month-end. 

2) We win begin terminating employees randomly. 

3) We will open fire on anyone caught within 100 yards of a printer. 

If these steps do not stop the proliferation of memos, we will consider sending 
out an even stronger note on the subject. 


® SunOS also has a foimatter called t r o f f, which is equivalent to 
for typesetters and related printers. 


nro f f , except that it produces output 


microsystems 
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Here is the sample memo before formatting: 

.LP 

From: Board of Directors 
.br 

To: Vociferous Employees 
.br 

Cc: All Employees 
.sp 
. ce 

Cut Paper Waste on Memos 
.LP 

It has come to our attention that certain employees 

of this company have been printing 

.ul 

inordinate 

numbers of inter-office memos. As you know^ our 
distinctive Flying Headstone stationery is quite 
expensive. 

.LP 

We have decided to take three immediate steps to 

counter this 

.ul 

threat 

to corporate profitability: 

.IP 1) 

We will reduce paper stocked for the printers by 25% within 
month-end. 

.IP 2) 

We will begin terminating employees randomly. 

.IP 3) 

We will open fire on anyone caught within 100 yards of a 
printer. 

.LP 

If these steps do not stop the proliferation of memos 
we will consider sending out an even stronger note on 
the subject. 


To create the file you want formatted, you must learn the basic nrof f format¬ 
ting commands. AU of the lines that begin with a period character in the listing 
above are nrof f formatting commands. 

Then, to transform the “raw” nrof f file into a finished document, you must 
learn to run the formatter nrof f on the “raw” file. Finally, you can print out 
the formatted file. 


sun 

microsystems 
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7.2. Basic Formatting Use the text editor vi to create the file sample .memo, with all of the memo 

Commands text and formatting commands in it. 

To construct the “raw” nroff file for formatting, you wiU need the following 
nrof f formatting commands: 

. LP to left-justify a paragraph 

.IP to created an itemized paragraph (like this one) 

. ce to center text on the page 

. u 1 to underline portions of text 

. sp to create a blank line space 

. br to force the end of a line, a line break 

Left-Justified Paragraph Use the .LP command to begin a paragraph without indentation. .LP must 

appear all by itself on the line before the paragraph. 


Itemized Paragraph The . IP command begins an itemized paragraph. An itemized paragraph starts 

with an item, say the number one, 1, followed by an indented paragraph of text. 

Put .IP on its own line, followed by the item you want to marie the paragraph. 
The itemized paragraphs in the sample memo are enumerated paragraphs, but 
you can also begin itemized paragraphs with other items, like the nroff com¬ 
mands listed at the beginning of this section. 

Centering Text When you have a title, or headline, type the . ce formatting command on a line 

by itself, then type the text you wish to center on the next line. 


Underlining Text To underline text, type the . ul command on a line by itself, followed by the 

text you want underlined on the next line. Start a new line after the text you want 
imderlined, because all of the text on the line following the . ul command wiU 
be underlined. 


Line Spacing . sp creates an empty line, or line space in the file. Type . sp on a line by 

itself. 

Line Breaks When you want a line to end at a specific point, rather thdxi filling in all of the 

text until the next paragraph on the subsequent lines, type . br on a line by 
itself, just after the line of text that you want to end at a specific point. 


7.3. Running the Formatter Now, you should have a file in one of your directories called sample. memo. 

It should contain aU of the memo text and formatting commands, and it should 
look like the sample file, before formatting, that you saw near the beginning of 
this chapter. 
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Note; The option -ms means “run 
the formatter with the macro package 
ms.” A macro package is a set of 
formatting command definitions 
associated with the nrof f for¬ 
matter. 


To run the nr of f formatter on the file, formatting the text contained in it, type 
nr of f -ms, followed by the filename of the file that is ready to be formatted, 
the redirecting output symbol >, and the filename you want for the file after it is 
formatted and ready to go to the printer. 

For the file sample. memo, type: 


Figure 7-1 Running the nrof f Formatter 

r -:-^ 

venus% Is 

sample .memo (along with the other files in that directory) 
venus% nroff -ms saiq>le.inemo > saxtqple.ms 

venus% 

_ ^ 


Often, people give their formatted files a filename with the last part, or filename 
extension, of the macro package they used to format the file. 

It may take a little while for the nr of f to finish formatting the file. 


7.4. Printing the Memo 


To print the formatted memo, type Ipr followed by the filename of the format¬ 
ted file. 


Figure 7-2 Printing the Formatted File 

venu3% Ipr sait^le.ms 

venus% 

s._ 


1.5. Where to Find Out Since you now know the basic nroff commands, you may want to find out 

More About more. Look at Using nroff and trof f and Formatting Documents . 

Formatting 
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Searching Through Files 


Many people find that they want to search for a certain string of text within a file, 
but they would prefer not to look at the entire file to find it. 

, or ep is the answer to their worries, grep, or the global regular expression 

has a special meaning in SunOS. pnnter, searches through a file or files for the stnng, or expression, that you 

You will learn more about regular specify. This chapter will help you learn how to use grep effectively, 

expressions in Doing More with 
SunOS: Beginner* s Guide. 


8.1. Basic Searches with 

grep 


Figure 8-1 


To search for a particular character string in a specified file, use the grep ccMn- 
mand. If you have the file people in your working directory, you can search it 
with grep.^^ 


File to Search with grep 


ventjis% cat people 



Emily Dickinson 

X7984 


Edgar Allen Poe 

X9096 


Louisa May Alcott 
venus% 

X4236 


V 


J 


This file isn’t long. It would be easy to search it by looking at it, but we’re 
experimenting with the grep command. 

The basic syntax of the grep command is: 

grep string file 

where string is the word or phrase you want to find, and file is the file in which to 
look for it. 

To find out Edgar Allen Poe’s telephone extension, type grep followed by the 
portion of his name you want to use to search for him and the filename of the file 
you want to search, in this case people. 


You can create the 1 


cat people. 


vi, or redirecting the output of cat. To look at the file, type 


Xr microsystems 
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Figure 8-2 Searching with grep 


venus% grep Poe people 
Edgar Allen Poe X9096 
venus% grep Allen people 
Edgar Allen Poe X9096 
venus% grep alien people 
venus % 

---; 


You can use any part of Poe’s name to search for the line of the file that contains 
his phone extension. However, grep pays close attention to the case of the 
characters you want it to search for. That’s why it didn’t find anything when it 
searched for alien, beginning with a lower-case letter. 

Sometimes, grep will find more than one occurrence of the search string. 
When you want to find the phone extensions of all people with names that have 
the string A1 in them: 

Figure 8-3 grep Finds More Than One String 


r 


venus% cat people 


Emily Dickinson X7984 


Edgar Allen Poe X9096 


Louisa May Alcott X4236 


venus% grep A1 people 


Edgar Allen Poe X9096 


Louisa May Alcott X4236 


venus% 


V ... . 

J 


grep found the string A1 in the entry for Poe and for Alcott. 


8.2. grep with Multi- When you try to grep for a string that is more than one word long, you will 

Word Strings encounter a problem. For example, look for Louisa May in the people 

file. 

Figure 8-4 Caution: Trying to grep for a Multi-Word String 

- -- 

venus% grep Louisa Hay people 

May: No such file or directory 
people:Louisa May Alcott X4236 
venus% 

V_ J 


grep interpreted the instraction so as to search for the string Louisa, in the 
files May and people, rather than searching for the string Louisa May in 
the file people. That’s why grep typed out the error indicating that the file 
May doesn’t exist, then specified that the file people does indeed contain the 
string Louisa on the line giving Louisa May Alcott’s phone extension. 
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The way to prevent this confusion is to enclose all multi-word search strings with 
single or double quotes. Many SunOS commands require quotes around multi¬ 
word arguments.^® 

Figure 8-5 Properly Quoted grep Search String 



8.3. Searching More Than In Figure 8-4, you may have noticed that grep attempted to search for a string 
One File in two files. In fact, grep can search for a string in groups of files. 

When you have a whole directory of files, and you want to search for a specific 
string in all of them, type grep followed by *, the wild card character for a 
string of arbitrary length. For this example, return to the home directory you 
created in Chapter 4 on files and the file system and modified in Chapter 5 on 
SimOS commands. 

Figure 8-6 Searching A Directory of Files 



grep does not attempt to search directories, like hinterland, or their con¬ 
tents. 


Sometimes you may want to search for all the lines of a file that don’t contain a 
certain string. 

To do this, use the -v option to grep. For example, to find all of the lines in 
the user medici’s home directory files that don’t contain the letter e: 


8.4. Searching for Lines 
Without a Certain 
String 
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Figure 8-7 Searching for Lines That Don’t Contain a String 



8.5. Where to Find Out You have learned grep well, but when you want to become a grep expert, you 

More About grep can find out more in Editing Text Files and in the SunOS Reference Manual. 
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Timesaving Features 


Timesaving features on the SunOS system can make your work quicker and 
easier. In this chapter, you wiU learn about aliases and basic history command 
repetition and substitution, shorthand ways of typing many commands. In addi¬ 
tion, you will learn about mnning commands in the background, a procedure 
where you can instruct the system to execute multiple command lines at the same 
time. 


You can use the alias command to develop a shorthand for commands that 
you type frequently. Since you probably type the logout command every 
time you end a work session, it is a good example of a command you might want 
to abbreviate. 

To alias a command, type alias followed by the alias, then the command 
string you wish to alias. So, to abbreviate the command logout as lo: 


The alias Command 


/r 

venus% alias lo logout 

venxis% lo 

s 

venus login: 

k . 

J 


When you type the lo alias for the logout command, the system interprets it 
as if you had typed logout, and logs you out. 

Whenever you want to create an alias for a multi-word command string, 
remember to enclose the multi-word string in double quotes. So, if you want to 
abbreviate grep -vas gv: 


micros ystems 
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Figure 9-2 Aliasing a Multi-Word Command String 



A 

vetius% alias gv ”grep “V” 


venu5% pwcl 


/home/medici 


venu3% gv e * 


actors:Mon Mar 14 10:00 PST 1936 


wildetThat is all^ 


venus% 


V . . 



To learn more about aliases, see Setting Up Your SunOS Environment: 
Beginner’s Guide . 


9.2. The History 
Mechanism 


The SunOS system stores the commands you type using a history mechanism. 
You can reuse the commands you have typed with command repetition and com¬ 
mand substitution. 


Command Repetition Command repetition allows you to repeat previous command lines or parts of 

previous command lines. The two most common command repetition commands 
are: ! ! and ! $. 

! ! repeats the entire last command line you entered. For example, if you use 
more to view a file, and you miss the part of the file you want, you can repeat 
more just by typing ! !. 

Figure 9-3 Entire Command Line Repetition with ! ! 


r 

venus% more actors 

> 

(Here the file is diplayed) 


venus % !! 

more actors 

(file is displayed again) 

venus% 



> 


The system types out the command line repeated by ! ! so that you can make 
sure it is the right one. 

The ! ! syntax is the basis for a lot of more sophisticated timesaving commands. 
Later on, in the manual Doing More with SunOS: Beginner’s Guide, you’ll see 
how you can modify a recent command, allowing you to do a variety of opera¬ 
tions with only a few keystrokes. 

When you just want to repeat the last word on the previous command line, type 
! $. You can type both ! ! and ! $ anywhere in the current command line to 
repeat all or a portion of the previous line. 

For example, when you cat the mammals file you just created, you may want to 
print it out afterward. 
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Figure 9-4 Last Word of Command Repetition with ! $ 



Once again, the system types out the command line you are executing, so you 
can make sure it is right. 


Command Substitution Sometimes you may want to repeat a previous command line, but change a por¬ 

tion of it, perhaps to correct a mistake or to complete a repetitive task. Command 
substitution, a basic form of command editing, is useful for such corrections and 
tasks. 

For example, when you want to make a directory called animals (perhaps so 
that you can move mammals into it), you should type mkdir animals. 

But, if you make a mistake, you can correct your mistake with the command sub¬ 
stitution symbols, " ", the caret characters. 

Figure 9-5 Correcting Mistakes with Command Substitution 



You successfully correct the error with command substitution, and the system 
makes the directory animals. 

To use command substitution for repetitive tasks, consider that you may want to 
make five directories, for the five known kingdoms of life. You’ve already 
created the animals directory, but here is an easy way to create the rest of 
them. 
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Figure 9-6 Command Substitution to Aid Repetitive Tasks 



To learn more about the history mechanism, and command line editing, see 
Doing More with SunOS: Beginner’s Guide. 


9.3. Running Commands in Another way to save your time is by miming commands in the background, one 
the Background aspect of job control. In fact, you can mn several commands in the background 

at once. When you mn commands in the background, you can mn another com¬ 
mand, as usual, running it in what is called the foreground. 

To mn a command in the background, type the ampersand character, & , at the 
end of the command line. For example, to mn spell on the file mairanalsin 
the background: 

Figure 9-7 Running a Command in the Background 



The system works on commands you mn in the foreground. Is in this example, 
at the same time as working on the command you ran in the background, 
spell. 

When you list files in a directory where a command has started to type output 
into a file, the listing will contain the new file, even though the file is not yet 
complete. 

In this case, mammals . error is an empty file, because there are no spelling 
errors in the file mammals. 

The system won’t type the message indicating it has finished the background job 
until: 

1) it has finished execution of the background command 

2) you ask it to perform another command 


»sun 

Xr microsystems 
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To learn more about background processing and job control, see Doing More 
with SunOS: Beginner’s Guide. Since you have nearly completed the basic 
SunOS tutorial, be aware that Doing More with SunOS: Beginner’s Guide is the 
next manual that covers SunOS commands within the Beginner’s Guide series. 
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Online Documentation 


When you want quick access to documentation, or when you don’t have the hard¬ 
copy manuals around, try using the online documentation. The primary online 
documentation source is the Man Page, short for ‘ ‘manual page. ’ ’ Other online 
documents, and tutorials associated with programs, may help to meet your docu¬ 
mentation needs too. 


10.1. Man Pages Man Pages exist for just about every command you can type to the command 

prompt (and some that you can’t). Man Pages give a basic outhne of the com¬ 
mand, including the following sections: 

Name 

Name and function. 

Synopsis 

Syntax diagram. Name, followed by options (in brackets), and any further 
arguments, like filenames. 

Description 

Brief description of the command. 

Return Value 

Only in System Call Man Pages. Lists the value returned with successful 
and unsuccessful operations. 

Errors 

Only in System Call Man Pages. Lists possible errors. 

Options 

Usually, an itemized list of options in convenient order, with a brief descrip¬ 
tion of each option. 

Commands 

In the case of an interactive program, commands that you can type during 
program execution. 

Files 

Files related to the command. 

See Also 

Related commands and pertinent documentation. 
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Diagnostics 

List of diagnostic messages that may be produced. 
Bugs 

Known bugs, or problems with the command. 


To access the Man Pages, type man followed by the command name?^ 
1 s: An Example For example, to access the Man Page for Is: 


When you don’t know the name of the command you want to access, just its functions, try the -k option 
of the man command. See Doing More with SunOS: Beginner’s Guide for more information on man -k. 
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Figure 10-1 Accessing an Online Man Page 


venus% man la 

L3(iy 

NAME 


USER COMMANDS 


L$(l) 


Is - list contents of directory 
SYNOPSIS 

Is t -acdfgilqrstulACLFR ] name , . . 

DESCRIPTION 

For each name which is a directory^ Is lists the contents of 
the directory; for each name which is a file. Is repeats its 
name and any other information requested. By default, the 
output is sorted alphabetically. When no argument is given, 
the current directory is listed. When several arguments are 
given, the arguments are first sorted appropriately, but 
file arguments are processed before directories and their 
contents. 

OPTIONS 

There are a large number of options: 

-a List all entries; in the absence of this option, 

entries whose names begin with a period (.) are not 

listed. 

-C Use time of file creation for sorting or printing. 

-d If argument is a directory, list only its name; often 

used with *•! to get the status of a directory. 

-f Force each argument to be interpreted as a directory 
(Type q to quit, space to continue.) 


--More--(20%) 


man uses more to type the Man Page on the screen. 


Using an Option to Is When you read the Is Man Page, you may come across the -F (capital F) 

option to Is. This is a useful option to know about, the kind of discovery you 
can make when you read Man Pages for commands you already know about. 

Is -F lists the contents of a directory like Is, except that it appends a slash 
character, / , to each directory name to distinguish directories from files.^^ 

List (with the -F option) the directory with all the life forms in it. 


The -F option to Is also distinguished symbolic links from directories and files, but don’t worry about 
this for now. 
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Figure 10-2 Listing a Directory with Is -F 


r 

verms % Is -F 



A 

animals/ 

mammals 

monerans/ 

protistans/ 

fungi/ 
venu3% Is 

mammals.error 

plants/ 


animals 

mammals 

monerans 

protistans 

fungi 

venus% 

V 

mammals - error 

plants 



Congratulations — you’ve read the main portion of this manual and learned the 
basics of SunOS. You may find the appendices useful too. 
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A 

Command Summary 


This is a summary of all commands mentioned in this manual. Each command 
appears in alphabetical order by name, and includes a syntax diagram, and a brief 
paragraph describing its function. Separate sections list Wild Card Characters, 
Redirecting Output Symbols, History Mechanism Commands, and the Job 
Control Command covered in this manual. 

For information on control key usage, see Section 2.5 . 


alias alias aliased-commandunaliased-command 

assigns the alias aliased-command to the command string 
unaliased-command. 

be be 

is the interactive basic calculator program that can handle arithmetic 
functions like addition, subtraction, multiplication, and division. 
Type I Return I after each arithmetic expression to get be to evaluate 
it. Set the number of decimal places with scale = followed by 
the number of decimal places you desire in calculation results. 

cal cal [numeric-month] year 

types out a calendar of a given year, or optionally of a certain month 
of a year. 

cat cat filename . . . 

types a file or files to the screen, or redirects output (cat filename 
. . . > filename), into another file. 

cd cd [directory-name] 

or change directory, changes the working directory to the home 
directory, or optionally to the directory-name destination. 

cp cp source-filename destination-filename or 

cp source-filename destination-directory-name 
copies a file into a filename, or into a directory. Watch out for exist¬ 
ing files. 

date date [-u] 

types out the current date and time in the local time standard. With 
the -u option, date types out universal, or Greenwich Mean, 
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grep 

logout 

Ipr 

Is 

mail 

man 

mkdir 

more 

mv 

nrof f 



time. 

grep [-v] search-string filename . . . 

searches for the specified search-string in the specified file or files, 

and types out aU text lines containing the search-string. With the 

-V option, grep types out all text lines that don’t contain the 

search-string. 

logout 

logs out of the system. 

Ipr filename . . . 

prints out a copy of the file or files on the printer. 

Is [-t-T] filename ... or 
Is [-tF] directory-name . . . 

types out a listing of the specified files, or of the files and directories 
in the specified directory. The -t option types the listing in reverse 
chronological order by last time modified, and the -F option dis¬ 
tinguished directories by appending the slash symbol onto them. 

See Mail and Messages: Beginner’s Guide. 

man command-name . . . 

types out the Man Page, or manual page, for the specified command, 
giving information about syntax, options, etc., for that command. 

mkdir directory-name . . . 

makes a directory with name directory-name. 

more filename . . . 

prints out the file filename page-by-page, more is especially useful 
for long files. Use q to quit, the space bar to continue paging. 

mv source-filename destination-filename or 

mv source-filename destination-directory-name or 

mv source-directory-name destination-directory-name 

moves, or renames, a file to another file, a file to a another directory, 

or a directory to another directory. 

nroff -ms filename . . . 

formats the specified file. Often, you wiU want to redirect the output 
of nrofftoafile. Use any of the following formatting commands 
in the source file: 

. LP to \eft-justify a paragraph 

. IP to created an itemized paragraph (like this one) 

. ce to center text on the page 

. ul to underline portions of text 

. sp to create a blank line space 

. br to force the end of a line, a line break 
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passwd 

pwd 

rm 

rmdir 

spell 

trof f 
vi 



passwd 

changes password by prompting for old password and twice for new 
password. 

pwd 

types working directory name. 

rm [-r] filename ... or 
rm [-r] directory-name . . . 

removes, or deletes, specified files or directories. With -r option, 
removes recursively the contents of any directories, in effect deleting 
all children of that directory. 

rmdir directory-name . . , 

removes directories specified, when they are empty directories, 
spell filename . . . 

checks spelling of words in specified file and types possible misspel¬ 
lings out to screen, unless you redirect the output to a file. 

See Using nrof f and trof f . 

vi filename . , . 

text editor with the following commands (in command mode, unless 
preceded by a :); 

a add text 

c c substitute a line with a string (enters insert mode) 

cw substitute, or change, a word with a string (enters insert 

mode) 

dd delete the entire line the cursor is on 

dw delete the word, or portion of word, under and after the cur¬ 

sor 

h move left, or ‘ ‘west,’ ’ one character 

i insert text under the cursor (enters insert mode) 

j move down, or ‘ ‘ south, ’ ’ one line 

k move up, or “north,” one line 

1 move right, or “east,” one character 

o insert text on a new blank line after the current line (enters 
insert mode) 

0 insert text on a new blank line before the current line (enters 
insert mode) 

s substitute a character with a string (enters insert mode) 

X delete the character under the cursor 
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: q quit vi 

: q! quit vi, without writing changes 
: w save, or write a file 


A.2. Wild Card Characters ^ 


Wild card representing a one-character value in a filename. 


Wild card representing an arbitrary number of characters in a filename. 


A.3. Redirecting Output 
Symbols 


> Symbol representing redirecting output from a command to a filename. 
Watch out because > may write over the destination file. 

» Symbol representing appending output from a command to a filename. 
» will append onto, not write over, the destination file. 


A.4. History Mechanism 
Commands 


!! Repeats entire last command line at any point in current command line. 

! $ Repeats last word of last command line at any point in current command 

line. 

" " Substitutes portion of previous command line between symbols for new 
string after symbols. 


A.5. Job Control 
Command 


& Pushes command to background for execution while you are typing other 
commands in the foreground. 
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Glossary 


This glossary contains a list of SunOS terms in common use, especially in this 
manual. For commands, see the command summary appendix A , or the “cheat 
sheet” at the end of this manual. 

absolute pathname 

The list of directories starting with the root directory, specified as /, down 
through the file system tree structure to the file or directory in question, with 
each directory along the way separated from the others with an additional / 
character. The other types of pathnames are: simple and relative pathnames. 

account 

The means by which a user access the system and the system administrator 
assigns space for the user’s files and directories. Usernames and passwords 
are specific to accounts. 

alias 

An alias is a user-specified abbreviation, or alternate string, for a standard 
command string. 

append 

Attach to the end. 
append output 

Attach redirected output to the end of a file, 
argument 

Any word (string of characters separated by spaces or tabs) occurring after 
the command in a command line. 

arithmetic operator 

Symbols used to indicate and execute addition (+), subtraction (-), multipli¬ 
cation (*), and division (/). 

background 

You make a process mn in the background by typing an ampersand (&) after 
the command which invokes it. A command which runs in the background 
runs invisibly to you (unless it encounters an error); this way, you can con¬ 
tinue typing in input while the process executes. A process not in the back¬ 
ground is said to be in the foreground. 
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bug 

Any problem or error in the design or coding of a program, 
case-sensitive 

Treating lower-case and upper-case characters as two kinds of characters 
with separate functions. 

child directory 

The directory directly below “this” directory in the file system tree stmc- 
ture. 

colon mode 

In vi, the mode where you can write files or quit the program. Type : 
when in command mode to access colon mode. Besides command mode and 
colon mode, vi has insert mode. 

command 

A string of characters that one types to the system, expecting it to respond by 
performing a certain function unique to that command line. The command 
is sometimes called the “verb” of the command line “sentence.” 

command editing 

Modifying a previous command line for reuse as a new command, 
command line 

A string of characters beginning with a command followed by arguments, 
which aren’t necessarily required, including options, filenames, and other 
expressions. 

command mode 

In vi, the mode where you can type moving and deleting commands, as 
well as changing text commands that access insert mode, vi starts out in 
command mode; the other modes are insert mode and colon mode. 

command prompt 

The string of characters that the system types telling you it is ready to accept 
and interpret your next command line. Often, the command prompt includes 
the name of the system. 

command repetition 

Repeating a previous command line, or portion of one, for reuse as a new 
command line. 

command substitution 

Substituting a portion of a previous command line for reuse as a new com¬ 
mand line. 

concatenate 

Literally, to link together in series; when you concatenate a file onto another 
file, you add it to the other file’s end. In SunOS, though, the cat command 
displays a file on the screen. 

console 

The console is, loosely, the terminal where you communicate with the com¬ 
puter; if you’re running a multi-windows system such as SunView, the 
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console window is the window that the system uses to send you messages, 
control keys 

Keys that require that you press and hold down the I Ctrl I key while typing 
the associated character to perform a certain function. For example, 

I Ctrl-U I deletes the current command line before execution. Control keys 
are a way of extending the functionality of the keyboard. 

current directory 

See working directory. 

cursor 

The rectangular portion of the screen that moves as you t 5 q)e keys on the 
keyboard indicating your current position on the screen. 

debug 

To attempt to fix problems with programs, 
directory 

A “container” for files and other directories that resides within the SunOS 
file system in a tree stmcture. You can make, move, copy, and remove 
directories and their associated files. Really, directories are a special type of 
file. 

downtime 

Time when the computer is not working because of maintenance or an unk¬ 
nown problem. 

echo 

The way that the system types back the keys that you type onto the screen, 
editor: 

See text editor, 
empty directory 

A directory that doesn’t contain any files or directories: 
end-of-file character 

1 Ctrl-D I the character used to indicate when you have finished typing in a 
file. 

error message 

A character string that the system types to let you know that there is a prob¬ 
lem with a command, or perhaps with something else. Usually, the error 
message will give you some idea of how to correct the problem. 

escape keys 

Keys that require that you press and release the lEscl key before typing the 
associated character. Escape keys are a way of extending the functionality 
of the keyboard. 

expression 

An expression is a string of characters that signifies a certain meaning to the 
system. 
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file A “container” for text. You can create, move, copy, list, and remove, or 
delete files. They are a good way to save memos, phone lists, programs, and 
other portions of text. You can use a text editor to create and modify files. 

filename 

The name that you assign to a file. Try not to use special characters in the 
filename, because the system may misinterpret the filename as something 
else. 

filename extension 

A portion of a filename appended to the end, often demarcated with a period 
character. An example is the . ms designation at the end of filenames of 
nroff-formatted files. 

file protection 

The way that the system maintains some security over the contents of your 
files. 

file system 

In the case of SunOS, a tree-structured network of files and directories, 
through which you can move to access the files and directories contained in 
it. 

file system hierarchy 

The stmcture of the file system, consisting of a tree of files and directories, 
with a root directory at the “top,” and directories acting as parent direc¬ 
tories and child directories throughout. 

filling 

The process of placing a series of words on a line until the end of the line, 
then placing the words on the next line until the end of that line, and so on. 
The nroff formatter fills text unless you type a command, such as the line 
break command . br, indicating that it do otherwise. 

foreground 

See background. 

formatter 

See text formatter. 

Greenwich Mean Time 

The time at the Greenwich meridian, by which people establish all of the 
time zones on earth. Sometimes known as imiversal time. 

hardcopy 

A copy of a text file that is on a piece of paper, not stored somewhere on the 
computer. 

hidden files 

Files that don’t show up when you do a simple listing, because they have a 
period character as the first character in their filename. 

hierarchy 

See file system hierarchy. 
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history mechanism 

The way that the system keeps track of commands that you have typed pre¬ 
viously so that you can reuse them with command repetition and command 
editing.^^ 

home directory 

The directory you are in when you first log in to the system, which is also 
your personal root directory to aU the files and directories you create in your 
own area. 

hostname 

The name of a machine, or host, 
indent 

To put spaces or tabs before a section of text, particularly at the beginning of 
a paragraph. 

insert mode 

For vi, insert mode is the mode that you enter when inserting or changing 
text, and exit by typing [ Esc 1 . The other vi modes are: command mode 
and colon mode. 

interactive program 

A program that requires you to type commands to it after you have started it, 
rather than executing its function in fuU after you enter a single command 
line. 

interrupt 

To stop the execution of a command or program, 
job control 

The way that the system keeps track of all the commands that you run in the 
foreground and background, as weU as aU of the commands that other users 
may run on the system. 

keyboard 

A part of the Sun workstation, similar to a typewriter, that permits you to 
input characters that usually appear on the screen. 

lefl-Justify 

To put characters up against the left margin, or side of the page. Often men¬ 
tioned with nrof f formatting, when you may want to start a paragraph 
against the left side, without any indentation. 

line break 

A way to stop the flow of filling, so that a line of text ends at a specific point, 
with any fiirther words appearing on the next line. Often mentioned with 
nrof f formatting, when you want to stop filling a particidar section of text. 

line space 

A way to indicate a blank vertical spacing equivalent to one line, usually 
mentioned when formatting with nrof f. 

C shell only. 
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login 

Gaining access to the system, usually by typing a username and password, so 
that you can begin a woric session on the computer. 

login prompt 

The string of characters that the system types to let you know that it is ready 
to interpret your username when you decide to type it. 

logout 

Ending access to the system, usually when you finish your work and you 
don’t want a random person to have access to your account, perhaps causing 
damage to one of your files, or accessing sensitive information. 

Man Page 

An online manual page, accessible with the man command, that provides 
information on most SunOS commands. 

marker 

In this case, the - character is marker for options, so that when you type a 
command with an option, the system can figure out that you have typed an 
option, not another kind of command argument. 

message of the day 

A portion of text that the system may type when you first log in. The system 
administrator sometimes creates this message to let users know about down¬ 
time or other important system events. 

mode 

See command mode, colon mode, or insert mode, 
mouse 

A small, rectangular part of the Sun workstation, with three buttons and a 
wire running out of it, that permits better control of the window system, 
when it is running. The mouse usually doesn’t have fur. 

mouse tablet 

A shiny, flat, rectangular part of the Sun workstation that permits you to 
move around your mouse in a way that the system can understand. 

natural language 

The languages that people, as opposed to machines, speak, read, or write in 
societies and cultures of all eras. 

online documentation 

The system of Man Pages that permits you to access information about com¬ 
mands while you are logged in to the system (via the man command). 

operating system 

A collection of programs that monitors the use of the machine and super¬ 
vises the other programs executed by it. 

operator 

See arithmetic operator. 
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option 

A portion of the command line sometimes compared with an adverb because 
it modifies the effect of the command you type. 

output redirection 

See redirecting output. 

Pacific Standard Time 

The standard for time on the west coast of the United States, established pri¬ 
marily by the distance from Greenwich, England. 

parent directory 

The directory above “this” directory in the file system tree structure, 
password 

A character string that you type, usually just after your filename, to get 
access to the system. Keep your password secret, and change it when you 
think someone discovers what it is. 

pathname 

An identifier for the position of a file or directory with the tree stmcture of 
the file system. The three types of pathnames are: simple, absolute, and rela¬ 
tive. 

printer 

A physical device that takes electronic signals, interprets them, and types 
them out onto paper. 

printout 

A piece of paper produced by a printer that has the image of the characters 
from a file on it. 

program 

A series of instmctions that the system executes when you type the program 
name and commands associated with the program. A programmer writes the 
set of instmctions and figures out how to get the system to use them prop¬ 
erly. 

“raw” file 

For nrof f, a file that has formatting commands embedded within it, so 
that the formatter can produce a formatted document from it. 

read ahead 

See type ahead. 

redirecting output 

Causing what the system types as the result of a command to go into a file, 
rather than onto the screen. Basic output redirection requires use of the > or 
» symbols. 

relative pathname 

A series of directory names separated by /’s that locates a file or directory 
with respect to the current, or working directory. The other types of path¬ 
names are: simple and absolute pathnames. 
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root directory 

The “top” directory in the tree structure of the SunOS file system 

rub out 

To erase, or delete, off the screen. 

save a file 

See write a file. 

screen 

See terminal screen, 
search a file 

To look through the contents of a file, perhaps with grep, to find a certain 
character string. 

simple pathname 

A file or directory name, without mention of any associated directories, that 
one uses to access the file or directory. 

special characters 

One of a set of characters that have a meaning to the system, other than their 
meaning as a simple character. For instance, the exclamation point, ! , has a 
special meaning for the history mechanism, and you shouldn’t use it in a 
filename. 

status line 

For vi, the line the system types at the bottom of the interactive screen to 
provide information about the number of characters or lines in a file, or 
whether an instruction to write the file was successful. 

string 

A series of characters, 
subdirectory 

The child directory of a parent directory, or any directory below that child 
directory. 

suspend 

To halt, perhaps temporarily, the execution of a program, 
system administrator 

A person who tends the system, providing accounts, and hopefully solving 
any problems you have with the computer. 

tablet 

See mouse tablet, 
terminal screen 

A flat, rectangular part of the Sun workstation that you look at to see what 
you type to the system and what it types back. 


text 

Combinations of characters in strings, sometimes forming comprehensible 
language or command lines. 
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text editor 

A program with which you can create files and modify them. For SunOS, 
the primary text editor is vi. 

text formatter 

A program with which you indicate more concisely arrangements and attri¬ 
butes of text, some of which are impossible to achieve without the formatter. 
The primary SunOS formatter is nrof f. 

tree structure 

The way that many people describe the SunOS file system hierarchy, draw¬ 
ing an analogy between the structure of a tree and the structure of the file 
system. As with a tree, the file system originates with a root, a root direc¬ 
tory, which “grows” child directories on its branches. 

type ahead 

The way that the system lets you type new commands while it is still inter¬ 
preting and executing the current command. 

universal time 

See Greenwich Mean Time. 

SunOS operating system 

The operating system that mns on Sun workstations. See operating system 
for more information. 

username 

The character string with which you identify yourself to the system, usually 
assigned by your system administrator. 

wild card characters 

Characters that have a special meaning to the system, because they specify 
aU filename character strings that have a certain attribute. For example, the 
wild card character asterisk, *, indicates a filename string of arbitrary 
length. 

window 

A portion of the screen in which you can type commands or execute pro¬ 
grams while running the window system. 

window system 

A set of programs that allows you to divide up the screen into portions where 
you can type various commands and mn many programs at the same time. 

word 

A character string, separated from other character strings by spaces or tab 
characters. 

working directory 

The current directory in which, among other activities, you can type com¬ 
mands and list files. When you first log in, your working directory is your 
home directory. 

work session 

The time that you access the computer to work or play, between when you 
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log in and when you log out. 
workstation 

A Sun system made up of a keyboard, a terminal screen, a mouse, and a 
moose taWet, which yoo can o^ for profitabte woik or healthy recreation. 

write a file 

For vi, to save the changes you have made to a file, so that when you next 
access the file the changes will still be there. 
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Special Characters 
! ! command, 94, 110 
! $ command, 94, 110 
. (current working directory), 46 
. . (parent directory), 47 
/ 

name of root directory, 42 
word separator in path names, 42 

A 

abbreviation 
aliases, 93 
directories, 45 
home directory, 45 
parent directory, 47 
working directory, 46 
absolute pathname, 41 
account, 3,4 
actors, 35 
actresses, 34 
addition, in be, 60 
Alcott, Louisa May, 87 
alias command, 93, 107 
aliases, 93 

multi-word argument, 94 
ampersand character, 96, 110 
append 

output, 59 
symbol, 59 
to file, 59 
argument, 53 

enclosed in quotes, 94 
multi-word, 94 
quotes, 88 
arithmetic 

operators, 60 
program, 60 

asterisk character, 57, 60, 89, 110 

B 

background, running processes in, 96 
backspace key, 12 
backups, 31 
be command, 60, 107 


c 

cal command, 54,107 
calculator, 60 

decimal places, 60 
scale, 60 
calendar, 54 
caret character, 95 
carriage return, 5,12 
cat command, 24, 107 
cd command, 39,107 
changing directories, 39 
character 

addition, 60 
ampersand, 96, 110 
asterisk, 57, 60, 89,110 
caret, 95 
division, 60 
end-of-file, 24 
greater than, 58, 59,110 
line kill, 13 
multiplication, 60 
period, 46,47 
plus sign, 60 
question mark, 57, 110 
quote, 94 
slash, 60 
special, 24 
‘ ‘squiggle* *, 45 
string, 57 
subtraction, 60 
tilde, 45, 110 
underscore, 34 
wild card, 57, 89,107 
child directory, 39 
command, 53,56, 60 
arguments, 53 
as verb, 56 
editing, 95 
grammar, 53 
line, 53 

more than one at once, 96 
read ahead, 56 
repeat, 94 
substitution, 95 
syntax, 53 

syntax diagrams, 107 
type ahead, 56 
command editing, 95 
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command grammar, 53 
command line, 53 
command prompt, 6 
command repetition, 94 
command substitution, 95 
command syntax, 53 
control keys, 13 
Ctrl-\ 14 
Ctrl-C, 14 
Ctrl-D, 8, 14,24 
Ctrl-0,14 
Ctrl-Q, 14, 25 
Ctrl-S, 14, 25 
Ctrl-U, 13, 14 
Ctrl-W, 14 
Ctrl-Z, 14 
table, 14 

copying directories, 36 
copying files, 29 

into directories, 33 
problems, 29 
core file, 14 
cp command, 29, 107 
creating directories, 32 
problems, 32 
crypt command, 23 
cursor, 18 

D 

dance, 27 

date command, 53, 108 
-u option, 53 
delete 

character, 4 
line, 13,14 
word, 14 
delete key, 12 
deleting files, 30 
Dickinson, Emily, 87 
directories, 31 

abbreviations, 45 
changing, 39 
child, 39 
copying, 36 
creating, 32 
home, 38 
listing, 36 
making, 32 
moving, 36, 37 
parent, 39 
root, 39 

subdirectory, 37 
working, 39, 41 
division, in be, 60 
documentation, online, 101 
dot character (working directory), 46 
downtime, 6 


E 

editor, 65 

Elements of Style, The, 59 
end-of-file character, 24 
erase 

character, 4 
line, 13, 14 
word, 14 
escape keys, 14 
expressions, 53 

F 

figures 

font meaning in, 4 
file, 23 

appending to, 59 
clobbering, 59 
copying, 29 
create, 23 
definition, 23 
deleting, 30 
file system, 39 
filename, 24 
filename extension, 84 
hidden, 24,27 
listing, 27 
long, 25 

looking at, 24, 26 
moving, 27 

position in file hierarchy, 41 
printing, 27 
protection, 23 
“raw” nroff, 82 
removing, 30 
renaming, 27 
retrieval, 31 
searching through, 87 
security, 23 
units, 25 
writing over, 59 
file system, 23, 39 

file position in file hierarchy, 41 
hierarchy, 39 

files and filesystems, 23 thru 49 
filesystem, 23, 39, see also file system 
flag (option on command line), 56 
foreground, running processes in, 96 
formatting text, 81 

G 

Goldman, Emma, 27 
grammar, 53, 57 

greater than character, 58,59, 110 
Greenwich Mean Time, 53 
grep command, 87,108 
basic search, 87 
complement search, 89 
find more than one string, 88 
problems, 88 

search more than one file, 89 
-V option, 89 
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grep command, continued 
with argument quotes, 88 
with multi-word string, 88 
gryphon example file, 31 

H 

hardcopy, 27 
hidden files, 27 

history mechanism, 93, 94, 107 
home directory, 38 
abbreviation, 45 
pathname, 41 
returning to, 39 
hostname, 4 

I 

interactive programs, 60 

J 

job control, 96, 107 

K 

key 

backspace, 12 
carriage return, 5, 12 
control, 8,13 
delete, 12 
escape, 14 
L, 11 
O, 11 
one, 11 
rub out, 12 
Shift, 8, 13 
space bar, 12 
tab, 12 

to repeat function, 11 
zero, 11 
keyboard, 11 

illustration, 11 

L 

left-handed, 17 
left-justify, 83 
life, five kingdoms of, 96 
line kill character, 13 
listing directories, 36 
problems, 36 
listing files, 27 

in other directories, 36 
problems, 36 
login, 4 

incorrect, 5 
information, 6 
prompt, 4 
logout, 7 

Ctrl-D, 8, 14 
problems, 8 

logout command, 108 
Ipr command, 27,108 
Is command, 27,108 
-F option, 103 


1 s command, continued 
-t option, 57 

M 

machine name, 4 
macro package, 84 
mail, 61 

mail command, 108 
making directories, 32 
problems, 32 
man command, 102, 108 
-k option, 102 
name search, 102 
Man Pages, 102 
manual 

SunView I Beginner’s Guide, 18 
manual pages, 102 
marker, option, 56 
memo, sample, 81 
message of the day, 6 
meta-keys, 14 
mkdir command, 32, 108 
more command, 26,103,108 
mouse, l9 

left-handed, 17 
moving directories, 36, 37 
problems, 38 
moving files, 27 

into directories, 33 
problems, 28 
multiplication, in be, 60 
mv command, 27, 28, 108 

N 

natural language, 53 
New Year’s Eve, 53 
nrof f program, 81, 108 
. br command, 83 
. ce command, 83 
centering text, 83 
filename extension, 84 
. IP command, 83 
itemized paragraphs, 83 
left-justified paragraphs, 83 
line breaks, 83 
line spacing, 83 
. LP command, 83 
macro package, 84 
-ms, 84 

printing formatted file, 84 
running, 84 
. sp command, 83 
. ul command, 83 
underlining text, 83 

o 

online documentation, 101 
operating system, 4 
operators, arithmetic, 60 
option, 56 

as adverb, 56 
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option, continued 
marker, 56 
outer space, 53 
output 

start, 14, 25 
stop, 14,25 
throw away, 14 
output redirection, 58, 107 
symbol, 58 

p 

Pacific Standard Time, 53 
parent directory, 39 
abbreviation, 47 
passwd command, 7,109 
password, 4,5 
change, 6 
problem with, 7 
security, 6 
short, 7 

password prompt, 5 
pathname, 41 
absolute, 41 
home directory, 41 
relative, 41 
simple, 41 
period character, 46 
Poe, Edgar Allen, 87 
printing files, 27 
problems, 27 
printout, 27 
program 

interactive, 60 
interrupt, 14 
suspend, 14 

pwd command, 41,109 

Q 

question mark, 57, 110 
quotation 

Alice Walker, 24 
Emma Goldman, 27 
Oscar Wilde, 30 
quote character, 94 
quotes around arguments, 88 

R 

read ahead, 56 
redirecting output, 58, 107 
symbol, 58 

regular expressions, 87 
relative pathname, 41 
removing files, 30 
problems, 31 
renaming files, 27 
problems, 28 
revolution, 27 
rm command, 30, 109 
-r option, 38 
rmdir command, 109 
root directory, 39 


rub out key, 12 

s 

sample memo, 81 
scale in be, 60 
screen, 17 

searching through files, 87 
security, 23 

password, 6 
Shift key, 13 
shorthand, 93 
simple pathname, 41 
slash character, 60 
Socrates, 59 
space bar, 12 
special characters, 24 
spell command, 58, 109 
spelling correction, 58 
“squiggle” character, 45 
status line, 66 
string, explanation of, 57 
Strunk, Jr., William, 59 
subdirectory, 37 
subtraction, in be, 60 
SunOS, 4 

case-sensitivity, 5 
grammar, 53, 57 
lower case orientation, 5 
security, 23 
syntax, 53 
SunView, 18 
syntax, 53 

system administrator, 3, 5, 7 

T 

tab, 12 
tablet, 19 

left-handed, 17 
terminal screen, 17 
text editor, 23, 65 
text formatter, 81 
tilde character, 45, 110 
timesavers, 93 
tree structure, 39 
troff command, 109 
trof f program, 81 
type ahead, 56 
typing 

correction, 4, 12 
error, 12 

u 

underscore character, 34 
units file, 25 
universal time, 53 
username, 4 

/usr/lib/units file, see units file 
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V 

vi editor, 65, 110 
a command, 67 
adding text, 67 
cc command, 75 
changing text, 74 
character substitution, 74 
colon mode, 67 
command mode, 67 
create file, 65 
cw command, 75 
dd command, 77 
deleting characters, 77 
deleting lines, 77 
deleting text, 77 
deleting words, 77 
dw command, 77 
h command, 73 
i command, 76 
insert mode, 67 
inserting text, 76 
interactive screen, 66 
j command, 71 
k command, 72 
1 command, 72 
line substitution, 75 
movement keys, 70 
moving in file, 70 
o command, 76 
: q command, 68 
: q! command, 69 
quitting, 68 

quitting without saving work, 69 
s command, 74 
saving work, 67 
starting, 65 
status line, 66 
: w command, 67 
word substitution, 75 
writing a file, 67 
X command, 77 
Voltaire, 59 

w 

Walker, Alice, 24 
White, E.B., 59 

wild card characters, 57, 89, 107 
Wilde, Oscar, 30 
window, 18 
window system, 18 
mouse, 19 
tablet, 19 

working directory, 39,41 
abbreviation, 46 
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3.2. Calendar 
Type 
cal year 

for yearly calendar 

cal month-number year 
for monthly calendar 

3J.wad Cards 

? Single character wUd card. 

* Arbitrary number of characters. 

3.4. Redirecting Output 

System types output of command to file rather than 
screen, replacing current contents of file, if any. 

Tyite command-name >filename. 

System types output of command to file rather than 
screen, appending to current contents of file, if any. 
Type command-name »filename. 

3.5. Basic Calculatw 

Type be to enter interactive program. Type arith¬ 
metic expressions, using +, -, *,and /symbols, 
followed by I RETURN 1 . To change number of 
decimal places, type scale = number. 

4. Editing Files 

Type vi to enter text editor, then any of following 
commands (in command mode, unless preceded by a 

a to add text 

cc to substitute a line with a string (enters 
insert mode) 

cw to substitute, or change, a word with a string 
(enters insert mode) 

dd to delete the entire line the cursor is on 


dw to delete the word, or portion of word, under 
and after the cursor 

h to move left, or “west,’ ’ one character 

i to insert text under the cursor (enters insert 
mode) 

j to move down, or ‘ ‘south,’ ’ one line 

k to move up, or ‘ ‘north,’ ’ one line 

1 to move right, or “east, ’ ’ one character 

o to insert text on a new blank line after the 
current line (enters insert mode) 

O to insert text on a new blank line before the 
current line (enters insert mode) 

s to substitute a character with a string (enters 
insert mode) 

X to delete the character under the cursor 
:q to quit vi 

:q! to quit vi, without writing changes 

: w to save, or write a file 

5. Formatting Files 

Construct source file to run through nrof f for¬ 
matter, including any of the following commands: 

. LP to \eft-justify a paragraph 

. IP to created an itemized paragraph (like this 
one) 

. ce to center text on the page 

. ul to underline portions of text 

. sp to create a blank line space 

.br to force the end of a line, a line break 

To format the source file, type nroff -ms 
source-filename. You will probably want to redirect 
the output of nroff into a destination-filename, so 


you can print it out afterward. 

6. Search Files 

Type 

grep search-string filename 

to type out lines containing the string in a 
specific file 

grep search-string filename(s) 

to type out lines containing the string in more 
than one file 

grep -v search-string filename(s) 

to type out lines that don’t contain the string 

7. Timesavers 
7.1. Aliases 

To “alias,’’ or abbreviate a command string with an 
alias string, type alias alias-string command¬ 
string. 

8. History: Command Repetition 

! ! Repeat the entire last command line at any point 
in the current command line. 

! $ Repeat the last word of the last command line at 
any point in the current command line. 

9. Run Command in Background: Job Con¬ 
trol 

To run a command in the background, as ojqwsed to 
the more common method of running commands in 
the foreground, type a & after the command line. 
Then, you can type more commands to the command 
prompt, or even run mwe commands in the back¬ 
ground fa* simultaneous command execution. 

10. Online Documentation 

To see online Man Pages, type man command- 
name. 



Getting Started with SunOS 
Quick Reference 

This quick reference lists the commands presented in 
this manual concisely by function. Each listing 
includes a syntax diagram, and a brief description of 
the command. 

1. Work Session 

1.1. Log In 

Type username to system login prompt 
Type password to password prompt. 

1.2. Change Password 

Type passwd, followed by old password, and 
repeat new password. 

U. Log Out 

Type logout or ICTRL-D1 depending upon system 
setup. 

2. File System 

2.1. Create File 

Type cat > filename, then text ending with 
I CTRL-D 1 . cff see Editing Files. 

2.2. Make (or Create) Directory 

Type vRk.6.ir directory-name. 

23. Look at File 

Type cat filename 
or more filename. 

2.4. Print File 
Type Iprfilename. 

23. List Files and Directories 
Type 

1 s for listing of current directory 


Is directory-name 

for listing of another directory 

Is filename 

for listing of a single file 

Is -t or 

Is -t filename or 

Is “t directory-name 

to get a listing reverse sorted by time of last 
modification 

Is -F or 

Is -F directory-name 

to get a listing that marks directory names by 
appending a / character to them. 

2.6. Move (or Rename) FOes and Directories 

Type 

mv source-filename destination-filename 
to rename a file 

mv source-filename destination’directory 
to move a file into another directory 

mv source-directory-name destination-directory- 
name to rename a directory, or move it into 
another directory. 

in. Copy Files 

Type 

cp source-filename destination-filename 
to copy a file into another filename 

cp source-filename destination-directory 
to copy a file into another directory 

2.8. Remove (or Delete) File 

Type 

rm filename 

to remove a file 


rmdir directory-name 

to remove an empty directory 

rm -r directory-name 

to remove a directory and its contents. 

2.9. Change Working Directory 
Type 

cd to change directories to your home directory 
cd directory-name 

to change directories to another directory. 

2.10. Find Name of Current Directory 
Type pwd. 

2.11. Pathnames 

simple: One filename or directory name to 

access local file or directory. 

absolute: List of directory names from root 

directory (first /) to desired 
filename or directory name, each 
name separated by /. 

relative: List of directory names from 

current position to desired filename 
or directory name, each name 
separated by /. 

2.12. Directory Abbreviation 

Home directory. 

' username Another user’s home directory. 

Working directory. 

Parent of working directory. 

3. Commands 
3.1. Date and Time 

Type date. For universal time (Greenwich Mean 
Time), type date -u. 
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